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PREFACE 

This manual describes the OASIS Operating System and provides the detailed 
information necessary to use the operating system, utility programs, file 
management, user accounting, etc. 

This manual, named SYSTEM , like all OASIS documentation manuals, has the manual 
name and revision number (if applicable) in the lower, inside corner of each page 
of the body of the manual. In most chapters of the manual the last primary subject 
being discussed on a page will be identified in the lower outside corner of the 
page. 



This manual describes some features that are only available with the multi-user 
version of the OASIS operating system* For documentation purposes , any information 
that pertains to multi-user only will be denoted by the vertical bar character in 
both margins, similar to this paragraph. j 

i 
Version Numbers 

All OASIS operating systems and command programs have version numbers. The version 
number of the operating system is displayed each time that the system is booted. 
The version number of programs may be determined by using the SET command to turn 
the version display on. It is important for you to know the version of your system 
and its programs in case there is any difficulty and you have to communicate with 
your distributor. 

All OASIS reference manuals also have version numbers. The version number of a 
manual is displayed on the title page, i.e., Second Edition. It is possible that a 
manual may be revised. When this is the case the manual will have a revision 
letter, i.e., Revision A. Each and every page that a revision affects will have 
the revision letter as part of the footing, after the manual name, i.e., SYSTEM 
( Rev A) . When communicating with your distributor regarding documentation be sure 
to tell him the version and revision number of your manual. 



Referenced or Related Material 

The following manuals provide information describing other programs available to 
the OASIS user: 

OASIS BASIC Language Reference Manual 
OASIS SCRIPT Processor Reference Manual 
OASIS Text Editor Reference Manual 
OASIS EXEC Language Reference Manual 
OASIS MACRO Assembler Language Reference Manual 
OASIS DEBUG Reference Manual 
OASIS Diagnostic A Conversion Utility Program Reference Manual 
OASIS Couunications Reference Manual 
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CHAPTER 1 

INTRODUCTION TO OASIS 

This version of OASIS is single-user or multi-user, programming and operating 
system designed ' for Z80 based micro computers. It permits a wide range of 
peripherals (printers, terminals, disk drives, etc.) and up to 784K of memory. 

1.1 OASIS Design Philosophy 

The OASIS Operating System was designed with four major ideas in mind: 1) OASIS was 
to be implemented on micro-computers but have features traditionally found on mini 
and mainframe computers; 2) OASIS would be implemented on machines from several 
manufacturers; 3) the micro-computer market consists of mainly uninitiated computer 
users; 4) programers and systems designers are accustomed to having an operating 
system perform all of the tedius tasks required in program development and 
execution. 

The first idea was easily solved as the background of the designers of OASIS is 
almost exclusively in mini and mainframe machines and both in OS design and 
applications design and programming. Users of OASIS will find many programs, 
concepts and syntax familiar if they have used mainframe computers or 
minicomputers. 

The second idea was more difficult to implement because it implies machine 
independence. Although OASIS is not totally machine independent there are only a 
few sections of OASIS that require information specific to a machine. OASIS is 
designed very modularly, allowing for small changes to be made for implementation 
on another machine. All programs written by the user on one machine with OASIS can 
be executed on another with no changes to the user program. 

The third idea of uninitiated users is the most difficult. Partial solutions to 
this problem were implemented by making all functions of the operating system 
consistent; by providing a "help" feature in each command: by using English words 
for command names; and by providing a means for system's developers to create 
pre-stored command sequences for specific functions to be carried out by the end 
user. 

The fourth concept was fulfilled by making all of the various functions of the 
commands intrinsic functions of the operating system. Some operating systems 
require a language product to be used for file management, peripheral input and 
output, etc. In OASIS all of these functions and more are part of the operating 
system. Language products merely access the operating system to perform specific 
functions. This implies easy programming and program versatility. 

1.2 Components of OASIS 

OASIS is composed of many programs but these programs can be divided into a few 
major categories: 

Nucleus The SYSTEM. NUCLEUS is a large section of instructions consisting of 
general purpose subroutines that provide the "intelligence" and 
integration of the system as a whole. It is the SYSTEM. NUCLEUS that 
is "booted" into memory when the system is first turned on. ("Boot" 
is a term referring to the process of "picking yourself up* by your 
bootlaces". In computers it indicates that there are a few 
instructions that provide the means of accessing more instructions, 
that in turn provide the means for more, etc.) 

| With the multi-user version of the OASIS operating system it is the 

NUCLEUS that controls the scheduling, memory management, and system 
i resource sharing of the multiple users. 

Associated with the NUCLEUS (but physically separate) are device 
driver programs. These programs contain instructions designed to 
handle one specific peripheral device. The device driver programs 
are responsible for the actual acceptance and transmittal (input and 
output) of data to a device, error detection and error handling, and 
the initialization of the device. 

CSI The Command String Interpreter is the hub of OASIS communications; it 
provides access to system and user programs, and performs input and 
output functions. The combination of the nucleus, device drivers and 
the CSI is the essence of the OASIS operating system. Through them 
all computations, input and output are performed. 

Programs The various programs of the OASIS system provide the "sophisticated" 
means of processing information. It is sophisticated in the 
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technical sense in that the various programs provide the intelligence 
to process information and data instead of just characters or 
"bytes". These programs consist of the system commands described in 
subsequent chapters of this manual and the language processors such 
as the MACHO assembler, Basic, EXEC, etc. 

1.3 Prograa Development Features 

Computer systems are often used extensively for program development. The 
programmer makes use of the programming "tools" available on his system to develop 
programs which will perform functions specific to his needs. The number and type 
of "tools" available on any given system depend on a good many factors - the size 
of the system, its application and its cost, to name a few. The OASIS system, 
however, provides several basic program development aids not commonly found on 
micro-computers i system editor, macro assembler, linkage editor, on-line debugger, 
and high level languages? BASIC and EXEC. 

The editor is used to create and modify textual material. Text may be the lines of 
code which make up a source program written in some programming language, or it may 
be data; text may be reports, or memos, or in fact may consist of the text in this 
publication. (This manual and the other OASIS manuals were developed and printed 
using the editor and SCRIPT, an optional OASIS program.) In this respect using an 
editor is analogous to using a typewriter-- the user sits at a keyboard and types 
text. But the advantages of an editor far exceed those of a typewriter because 
once text has been created, it can be modified, relocated, replaced t merged, or 
deleted — all by means of simple editing commands. When you are satisfied with the 
text you can save it in a disk file where it is available for later reference and 
use . . 

When the editor is used for the purpose of writing a source program, development 
does not stop with the creation of this program. Since the computer cannot 
understand any language but machine language (a sequence of discrete codes), an 
intermediary program is necessary which will convert source code into the 
instructions the computer can execute. This is the function of an assembler, 
compiler, or interpreter. 

An assembler accepts alphanumeric representations of instructions, interprets the 
code, and produces as output the appropriate object code. You can direct the 
assembler to generate a listing of both the source code and binary output, as well 
as more specific listings which are helpful during the program debugging process. 
The assembler is capable of detecting certain common coding errors and of issuing 
appropriate warnings. 

In addition to the normal features of an assembler, the OASIS MACRO Assembler 
provides a wide range of directives, system calls (subroutines in the operating 
system accessible to user programs), and macro capability. 

Source programs may be complete and functional by themselves; however, some 
.programs are written in such a way that they must be used in conjunction with other 
programs in order to form a complete and logical flow of instructions. For this 
reason the object code produced by an assembler must be relocatable — that is, 
assignment of memory locations must be deferred until the code is combined with all 
other necessary object modules. It is the purpose of the linkage editor to perform 
this relocation. 

Very rarely is a program created which does not contain at least one unintentional 
error (bug.). Often it is not until execution that the user discovers that a 
program is not working properly. Programming errors may be extremely difficult to 
find, and for this reason a debugging tool is usually available to aid the 
programmer in determining the cause of error. 

The OASIS debugging program allows the user to interactively control the execution 
of the program. With it, you can examine the contents of individual locations, set 
designated stopping points during execution (break points), change the contents of 
locations, continue execution, dis-assemble portions of the program, and add new 
instructions using mnemonics instead of machine code. 

A high level language, such as the OASIS BASIC interpreter/ compiler, provides an 
alternate means of writing a source program other than assembly language mnemonics. 
High level languages are easy to learn — a single command may cause the computer to 
perform thousands of machine language instructions. In a high level language you 
do not need to know about the mechanics of the computer. In addition, the OASIS 
BASIC compiler offers a special immediate or command mode which allows you to solve 
equations and formulas, or to interactively debug the program, similar to the 
debugger for assembly language programs. 
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SYSTEM COMMUNICATKMI 

The Command String Interpreter is the hub of OASIS system communications — it 

Provides access to system and user programs, and contains the Executive Procedure 
rocessor. The various system programs (utilities) accessible through the CSI are 
discussed in subsequent chapters of this manual. Major utilities, such as EDIT, 
EXEC, MACRO, etc., are described in separate manuals. 

2.1 System Start Procedure 

To load the OASIS operating system and start the CSI the following procedure must 
be followed. 

1 . Turn the power on. If the power is already on then use the reset 
button, if available. 

2. Load an OASIS system disk in drive 1 and start the drive. 

3. After a short time the following message will be displayed on the 
console: 

Single-user OASIS version v.r - nnK 

or ; 

J Multi-user OASIS version v.r - nnK i 

The v.r will be replaced by the current version and release number. 
The nn will be replaced by the amount of memory on your particular 
machine. If the message is not displayed after a reasonable period 
of time (5-10 seconds), unload the disk and reload it, making sure it 
is being loaded in the proper direction, etc. 

4. The system will then display: 

Time (HH:MM:SS) 

At this point enter the correct time of day, preferrably in 24 hour 
format. It is not necessary to enter the seconds or any leading 
zeros. 

You may enter a carriage return only instead of the current time. 
When this is done the system will use the time of the last system 
start-up. " " 

Note: not all systems on which OASIS is implemented support this time 
of day feature. If your system does not support this feature this 
question will not be asked. . 

5. The system will then display: 

Date (MM/DD/YY) 

Enter the correct date. It is not necessary to enter leading zeros. 
The date entered must be a valid date, and must be greater than 
01/01/77. You may enter the date using the month name such as: 

Date (MM/DD/YY) 15 April 1978 

or in some other reasonable format. 

You may enter a carriage return only instead of the current date. 
When this is done the system will use the same date as that used at 
the last system start-up. It is permissable to omit the year number. 
When this is done OASIS will use the year number of the last start 
up. 

6. After a valid time and date have been entered the system displays the 
current time and date along with month name and day of week. Then 
the system locates the NUCLEUS. CSI, EXECSAVE. and ERRMSG files on 
the system disk, loads the NUCLEUS and CSI, finds and loads all of 
the ATTACHed and SYSGENed device drivers, and passes control to the 
CSI. If any of these files cannot be found on the system disk an 
error message is displayed. 

The location of these modules by the "boot" process saves 
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considerable time during processing because no searches need be made. 
The tradeoff to this advantage is that the system disk may not be 
changed without re-locating these files „ 

When the system is brought up in the manner described above the system attempts to 
automatically log onto the IPL account. In this automatic logon procedure a search 
is made of the file SYSTEM. ACCOUNT for the account IPL. When this account is found 
in the file the system logs onto the account. As discussed in the chapter on User 
Accounting, when an account is logged onto, a search is made of all attached disks 
for a file named; IPL. EXEC accessible 6y the account IPL (public or private 
access). This is the file name of the EXEC language program to be executed upon 
system logon. When the file is found control of the system is transferred to it* 
When the file cannot be found the CSI retains control and the prompt character is 
displayedo 

If no logon start up program is desired s you should create an empty file named 
<account nameXEXEC on the system disk. This will speed up logon start time 
because an exhaustive search is not made. 

For details on using the EXEC language refer to the EXEC Language Reference Manual . 

When the search is made of the SYSTEM. ACCOUNT file and no IPL account is found, the 
system will automatically execute the LOGON command. This command will ask you to 
enter the name of the account that you wish to log onto. For complete details of 
this command refer to the chapter on the LOGON Command. 

To simulate an operating environment without user accounting use the KILL option of 
the ACCOUNT command. This will delete the SYSTEM. ACCOUNT file. When no 
SYSTEM. ACCOUNT file is found the system reverts to a non-accounting environment. 

OASIS is distributed with no SYSTEM. ACCOUNT file defined. 

An example system start up dialogue, single user system, without a SYSTEM. ACCOUNT 
file defined: 

Single-user OASIS version 5.5 - 64K 

Time (HH:MM:SS) 1159 

Date (MM/DD/YY) 062281 

11:59:02 Monday, June 22, 1981 

> 

2.2 Dynamic Input and Output 

As mentioned earlier, the NUCLEUS contains the instructions to handle peripheral 
input and output devices. These groups of instructions are called device drivers* 
In this manual these drivers are referred to as physical device drivers. Physical 
device drivers are programmed to meet the specific requirements of a specific 
device. An example of a physical device driver is the program containing the 
instructions necessary to handle a serial input/output port (SIO). The driver for 
the SIO has to have instructions capable of performing input or output on a bit by 
bit basis at a specified rate (baud). 

To make programming and operation of the system more versatile the OASIS operating 
system communicates with physical device drivers by means of a logical device name. 
The logical device name is nothing more than a linkage that points to a specific 
device driver. By using logical device names instead of the physical device 
numbers (physical device drivers are accessed by the number of the driver - refer 
to the appendix) it is very easy to change the input or output device of a program* 
All that is necessary is to change the number of the device driver that the logical 
name is pointing to. 

Only physical device drivers are capable of communicating with the w real w world 
outside of the computer. The connection between the logical device driver and the 
physical driver is made by using the ATTACH program. 

By making the connection between logical and physical device drivers dynamic, or 
changeable, you gain a great deal in versatility. Programs are created with 
specifications such as printing to the printer or console. With no changes 
required in the program the output can be changed from a parallel interface line 
printer to a serial interface line printer, or from a serial interface line printer 
to a video display monitor, etc. 
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CHAPTER 2: SYSTEM COMMUNICATION 
2.3 Configuring Your Systea 

The ability to dynamically associate physical and logical device drivers would be a 
nuisance if it had to be done every time the system was turned on. Also it would 
be inconvenient if you had to set the status of all the internal switches in OASIS 
every time (see the SET command). 

To avoid this inconvenience OASIS provides the SYSGEN program. With It you can 
"permanently" set the attached devices and switches. When the SYSGEN program is 
executed the current linkages of attached devices are saved in the disk image of 
the system nucleus. The next time the system is turned on the attachments and sets 
will already be in effect. (See the ATTACH, SET, and SYSGEN commands.) 
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CHAPTER 3 

USES ACCOOHTIHG 

The OASIS Operating System supports user accounting and restricted file access 
between user accounts. User accounting means more than the mere record keeping of 
the time that each person uses the system. In OASIS it also means that a user may 
only access the public (common) files and programs, his own files and programs 
(private files), and those select files and programs of other users who have given 
him explicit permission to access them (shared files). Similarly a user's riles 
and programs may not be accessed by any other user without his explicit permission. 
Additional accounting information is generated for system restarts. 

3d File Ownership 

User accounting utilizes the concept of file ownership. In a user accounting 
system each file is "owned" by one account and only one account. Files owned by a 
user account are referred to as "private" files. Private files may only be deleted 
or changed by the owner of the file. Under certain conditions a user account may 
have access to another user's private files. When this is true those files owned 
by the other account are referred to as "shared" files to the non-owner of the 
file. File sharing is strictly controlled by the operating system. A shared file 
may be changed by the non-owner but may not be deleted. 

A special type of shared file is the "public" file. A public file is a file owned 
by the system account and all users have access to them without the necessity of 
specifying them as shared files. Usually the system programs. are kept in the 
system account so that all users may utilize them. 

The above ideas may best be clarified with an example. Suppose that a system has 
the following accounts and files: 

Account File 



System BASIC . COMMAND 
RUN. COMMAND 
EDIT. COMMAND 
ERASE. COMMAND 
RENAME. COMMAND 
FILELIST. COMMAND 

RALPH LEDGER . MASTER 
LEDGER. DETAIL 
LEDGER. HISTORY 
LEDGER. BASIC 

LINDA PAYROLL . MASTER 
PAYROLL. DETAIL 
PAYROLL. HISTORY 
PAYROLL. BASIC 



If no files are designated as being shared files then RALPH can use the programs? 
BASIC, RUN, EDIT, ERASE, RENAME, and FILELIST (public files); he may execute the 
BASIC program LEDGER, and he may change or delete the data files: LEDGER . MASTER , 
LEDGER. DETAIL, and LEDGER . HISTORY (private files). When RALPH is logged on the 
system he would not even know about LINDAS files nor could he access them in any 
way. 

LINDA can use the programs: BASIC, RUN, EDIT, ERASE, RENAME, and FILELIST too. 
However she may only execute the BASIC program PAYROLL and she may only change or 
delete the data files: PAYROLL. MASTER, PA YROL . DETAIL , and PAYROLL. HISTORY. 
Similarly when LINDA is logged on the system she would not know about RALPH'S files 
nor could she access them in any way. 

When the system account is logged onto (usually only done for system maintenance 
purposes) neither RALPH'S files nor LINDA'S files could be accessed in any way. In 
this case there are no public files and the system account cannot have shared 
files. 

Assuming that RALPH'S program and files perform General Ledger accounting functions 
and that LINDA'S program and files perform Payroll processing it would probably be 
best if RALPH specified that his files: LEDGER. MASTER and LEDGER . DETAIL could be 
shared by LINDA. If this were done (using the SHARE command) then LINDA could 
create General Ledger entries reflecting her Payroll processing in RALPH'S files. 
(LINDA could not delete these files— only the owner of a file can delete it.) 

Say that Ralph gets fired and Linda is promoted to do both Payroll processing and 
General Ledger accounting. Before removing the account RALPH from the system 
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(using the ACCOUNT command) his files should be transferred to the account LINDA. 
When this is done (using the OWNERCHG command) the LINDA account would own her 
original four files plus the four LEDGER files previously owned by the RALPH 
account. 

IMPORTANT! Extreme care should be taken when deleting an account name from the 
system. Before deleting the account all shared access to any of the accounts 
files should be removed (using SHARE command) and then any of the accounts files 
to be kept should be transferred to another account. Any files that are not to be 
used again should be deleted. 

If the above procedure is not done before an account name is deleted YOU MAY NOT 
EVER BE ABLE TO ACCESS TkOSE FILES AGAIN. Re-adding a deleted account does not 
necessarily make the deleted account's files accessible. 

3*2 Adding Accounts 

As mentioned in the above example there are special programs that perform the user 
accounting features. When an OASIS system is first received it has no accounts. 
To start using the accounting feature you will have to add accounts with the 
ACCOUNT command. The ACCOUNT command allows new account names to be added and 
allows maintenance (changing and deleting) of existing accounts. 

Before any new accounts are added to the system the user should determine whether 
or not the accounting feature is to be kept as a part of the system (it can be 
disabled but not easily re-enabled) . 

3*3 Prlvelege Levels 

When setting up new accounts (or changing existing ones) the question of privilege 
level is asked. The privilege level or an account determines which commands may be 
executed by the account. Each system command has its own privilege value 
associated with it. These privilege values may be changed by the user with the 
CHANGE command to conform to his own requirements. 

In the previous example assume that RALPH has a privilege level of and that LINDA 
has a privilege level of 1 and that the privilege values of the commands are 
unchanged from the distribution values (see Appendix "Privilege Levels"). In this 
case RALPH could only execute the commands RUN and FILELIST. His privilege level 
is not high enough to execute the other commands. This essentially restricts him 
from changing or adding any files in his account except under the control of his 
BASIC program (he has to use RUN to execute that program and RUN' does not allow the 
operator to make changes in the program.) 

LINDA, on the other hand, can execute all of the commands that are in the system 
account in the example. Therefore she. unlike the RALPH account, can erase files, 
rename files, edit files and use BASIC to debug and/ or make changes in her program. 
She still would not be allowed to erase or rename any of RALPH'S files even if she 
had shared access to them (also the EDIT command would not allow her to change any 
of RALPH'S files because it erases and renames a file in the process of updating 

1 vj • 

/'"•■■ 

It is best to leave the system account (or a synonym of it) at the highest 
privilege level available. This would allow anybody that had permission to log 
onto the system account to execute all of the commands in the system. 

3*4 Account Synonyms 

The word synonym was used in the last section. A synonym of an account is an 
account that is identical to the account it is a synonym to but has a different 
name, and possibly a different password and/or privilege level. In the example 
where RALPH has a privilege level of the question of file maintenance arises: How 
can RALPH'S program be changed? One way would be to set up another account that 
has shared access with RALPH'S program file, copy the file from RALPH'S account 
into the new account (giving it a unique name), performing the required 
maintenance, establishing it as a shared file with the RALPH account. Now the 
RALPH account can use the new version of the program. Obviously this is rather 
tedious. 

A better way would be to establish a new account that is a synonym to the RALPH 
account that also has a privilege level of at least 1 . When this new account is 
logged onto (say it was named MICHELLE) the account will have the the same file 
access as the RALPH account but the privilege level will be 1 . This privilege 
level allows the execution of the EDIT command. Any changes made while MICHELLE is 
logged on will be made to the RALPH files. 
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Synonyms have another important use . Even if the password and privilege level are 
the same between an account and its synonym, the account name will be different. 
This means that any accounting history generated by the two accounts will be 
distinguishable. 

3*5 Account Passwords 

Another question asked when an account is added or changed is the account password. 
All accounts have a potential password associated with them. When a password is 
defined for an account it must be used each time an operator attempts to log onto 
the account. If the operator does not know the password he or she will not be able 
to log onto that account. This implies that the operator will not be able to 
access any of the files or programs that are owned by that account and not shared 
with other accounts. 

When the owner of an account (or anyone else who knows the password) logs onto an 
account and enters the password the password is not displayed as it is entered. 
This prevents others who don't already know the password from inadvertantly finding 
out. The password provides a reasonable level of file and account security. 

3.6 Accounting History 

As stated at the beginning of this chapter, user accounting implies the collection 
of user account accounting information, in the OASIS system a history record is 
generated every time a user logs onto or off of an account. This history record 
contains the information answering the questions: Who logged onto the system? When 
did they log onto the system? and How long were they logged onto the system? 
Additional information is recorded showing when the system was booted, when a disk 
was backed up and to where. 

This account history information is kept in the special file named SYSTEM. HISTORY. 
This file is special in the sense that no account owns it. This history file, 
similar to the account name file SYSTEM. ACCOUNT, cannot be accessed by any user. 
The SYSTEM. HISTORY file (and later the ACCOUNT. HISTORY file) contains records 
accounting for each system start up, each user LOGON and LOGOFF. 

In order to access the accounting information kept in the history file you must use 
the option CLEAR in the ACCOUNT command. This option will transfer the data in the 
SYSTEM. HISTORY file to the system account's file ACCOUNT. HISTORY. Once this has 
been done the information is accessible to all users as the file is public. This 
procedure should be done periodically anyway as the SYSTEM. HISTORY file can grow to 
use up all the space on your system disk. 

When the SYSTEM. HISTORY file does grow to use all of the space available on the 
system disk the program that was trying to add a record to the history file will 
inform you that it has used all the space available and that you should use the 
ACCOUNT command to clear the file. when this is done there still won't be any 
space available but you will have access to the ACCOUNT. HISTORY file and can either 
erase it or copy it to another disk and erase the file on the system disk. If you 
do not make space available for the SYSTEM. HISTORY file no more accounting records 
will be added but you will be allowed to log on and off accounts. 

This accounting history feature is optional and may be enabled or disabled by the 
user (see the SET command). OASIS, as distributed, has this history feature 
disabled. 
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MULTI-OSER OASIS 

OASIS, versions 5.4 and above, is available in single and multi-user versions. A 
multi-user operating system is a system that allows more than one user (console) to 
be controlling the computer at one time. Each user in a multi-user system operates 
as if he had the complete attention of the computer to perform his task. 

In multi-user OASIS each user is given a portion of memory to have exclusively. 
Additionally, each user has access to the single copy of the operating system in 
memory and any re-entrant programs that may be available. A re-entrant program is 
a program , that can be utilized by more than one user at a time, without having 
multiple copies of the program in memory. OASIS BASIC is a program that is 
available as a re-entrant command. 

Although a computer can only perform one single operation at a time it operates at 
such a high speed that it can service several users at one time by switching 
between users, giving a portion of time (a time slice) to each user. When the time 
slice is used up the system suspends the operation of that user and allows another 
user to have a time slice. When that user has exhausted his time slice the next 
user is selected and so on. Because a computer operates at very high speeds this 
sharing of time is generally transparent to the user. 

A user may lose his time slice if, for any reason, he is waiting for an input or 
output process to complete. 

Certain problems may arise when using a multi-user operating system. Specifically, 
the situation may arise that two users try to update a disk file. Both users may 
have read in the same copy of a record, made changes to the record without the 
knowledge of the other user, and then written the changed record back. The record 
change written back last will be the change that is actually made to the file. 
This could be disastrous if the record was a balance record for example. 

In multi-user OASIS this situation can be easily prevented in one of two ways: the 
first user may put a lock on the entire file, thus preventing the second user from 
making any changes to the file; or both users may put a lock on the record— the 
user who puts the lock on the record first will prevent the second user from 
reading the record until the lock is released, thus insuring that the second change 
to the record will be made to the correct copy of the record. 

Multi-user OASIS requires that the user accounting feature be used and that each 
user be logged onto a different account. However, the accounts that the users are 
logged on to may be synonyms to each other. 

Multi-user OASIS also provides other convenient features: transmitting messages 
from user to user (MSG) , forcing a user to execute a command (FORCE), peeking at 
another user's console output through your own console (PEEK), display status of 
other users (SHOW MEMORY). Of course all of the single user programs and features 
are available too, including: user accounting; private, public, and shared file 
ownership; optional printer spooler; complete program development package — MACRO 
Assembler, debugger, linkage editor, BASIC compiler and interpreter; system 
diagnostic programs — disk verify, memory test; etc. 

4.1 Invoking Multi-user OASIS 

When multi-user OASIS is first booted into memory it is set up in single-user 
mode — only one user is defined. At this time the system's manager should define 
and initialize the users to be utilized. This is accomplished with the SET MEMORY 
command and the START command. As each user is started the respective consoles 
will request that the operators logon to an account. That is all that is necessary 
to use multi-user OASIS. This process of invoking multi-user mode may be 
I automatically performed if the system's manager .defines an account named IPL with 
an IPL. EXEC program that performs the necessary commands to set up the system. 



After some usage of the system the system's manager may decide that the time slice 
value (the amount of time allocated to each user partition) is not proper for the 
applications being used. This is changeable with the SET SLICE command. 



j A typical multi-user start up would look like: 
I 
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Multi-user OASIS version 5.5 - 64K j 

Time (HH:MM:SS) 830 j 

Date (MM/DD/YY) 622 j 

08:30:00 Monday, June 22, 1981 j 

Logon Please: IPL j 

>ATTACH A DISK2 (PUBLIC j 

>L0AD BASIC | 

>SET MEMORY 2 10240 | 

>START 2 (SI02 B19200 C4 FF6 j 

>SH0W MEMORY S 



Port Bank MEML0 MEMMX MEMHI SP PC Size Routine Username 

0000H 4CFFH 19712 NUCLEUS 

4D00H A886H 23431 BASIC 

1* D087H FDFFH FB21H FAF3H D087H 11641 SHOW IPL 
2 8 A887H D086H CDA9H CD87H CDCFH 10240 LOGON j 

>LOGOFF j 

8 

Logon Please.: j 

The above start up procedure will result in disk S and disk A being public (all 
users may access), two users, and re-entrant BASIC available to both users. As can 
be seen, this start up procedure is kept in the IPL. EXEC file in the account IPL. 
All entries after the date and before the LOGOFF were made by the system or the 
EXEC, nothing special had to be done by the operator. j 

I 
Your start up procedure might be different in the number of users, public disks and j 
whether or not the re-entrant BASIC is loaded. 

4.2 Single-user Mode 

When only one user is defined and active in the system the system is said to be in 
single-user mode. This mode is important because some tasks may only be performed 
in single-user mode, such as full disk backups, loading and unloading re-entrant 
programs and detaching public disk volumes. 

In the above start up procedure, note that the public disk and the re-entrant BASIC 
are both attached or loaded before establishing a second user to the system. This 
was done because these operations are required to be performed in single-user mode. 
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CHAPTER 5 
OASIS FILE MAHAGEMEHT 

The OASIS Operating System is essentially a file management system. The operating 
system consists of programs that manipulate or maintain files on the random access, 
mass storage device (disk drives) . Each disk may contain a mixture of data and 
program files. 

A file is a logical group of records, records being the individual elements. An 
example is a customer name and address file. The file is a group of customers; the 
records are the individual customer names and addresses. 

The operating system has the ability to handle up to eight disk drives, if 
available. However, each disk is maintained independently of others. This means 
that a file may not start on one disk and continue on another. A file must be 
completely contained on one disk. 

Each OASIS disk must be initialized before any files may be written to it. The 
initialization process is accomplished by using the program INITDISK with the 
FORMAT option. This program need only be executed once for a disk. However, there 
is no restriction on re-initializing a disk. The initialization process is 
necessary because a new disk, as received from the manufacturer, has no or wrong 
information written on it. The initialization process writes information on the 
disk necessary for OASIS to add files to the disk. The information written is a 
blank directory, a disk label, an allocation map indicating that the entire disk is 
available for new files, and data blocks. Data blocks are 1K blocks or sections of 
storage. 1K is a symbol representing 1024 bytes or characters. 

The directory is an index which contains the contents of the disk and pointers to 
the data areas which constitute the files on the disk. 

After a disk has been initialized, the other programs in the operating system can 
use it for adding files, changing files, erasing files, etc. 

5-1 Directory Naaing 

The files on a disk are accessed by specifying the file name, file type and the 
disk. The disk is specified by the disk label (established in the INITDISK 
program) or a one character directory label (established by the ATTACH program). 
This directory label is really just an indication of which disk drive the disk is 
in and only has meaning while the disk is in that drive. 

The directory label is one of the following characters: S,A,B,C,D,E,F,G. The S 
label is reserved to indicate the system disk and may not be attached to any other 
disk. (A system disk is the disk that contains the operating system programs and 
is the disk that the system was "booted" from at system start up time.) 

A directory label may be attached to only one drive at a time, and a drive may have 
only one label attached to it. 

5.2 Data and File Formats 

The OASIS system makes use of six file formats: ASCII sequential, direct, indexed, 
keyed, absolute, and relocatable. 

5.2.1 ASCII Sequential Files 

Files in ASCII format conform to the American National Standard Code for Informaton 
Interchange, in which each character* is represented by an 8-bit code. Files in 
ASCII format include program source files created by the Editor, listing files from 
the MACRO assembler, object files from the MACRO assembler, and data files from 
user programs. 

An ASCII file, when accessed by some of the. system programs, such as the Editor or 
BASIC, is read into memory as a whole. Other system programs and user programs 
usually access this type of a file one record at a time. The reason it is called 
an ASCII sequential file is that a record cannot be accessed without accessing all 
records prior to it in a sequential manner. 

This type of a file is the only format that supports variable length records. The 
length of a record is determined by the contents of that record, not by the access 
method. 

A sequential file cannot be updated in place. The only form of update that may be 
performed on a sequential file is appending records to the end of the file. Of 
course the file can be erased as a whole. 

SYSTEM Her B - 11 - 



SYSTEM REFEHEHCE MAOTAL 

The size of a sequential file is determined dynamically* When the file is first 
created it is allocated the minimum size: 1K bytes. When a record is added to the 
file that will not fit in the current allocation one more block of storage is 
allocated to the file and the record is written to the new area. This is the only 
file format that does not require contiguous data space. Each block of data may be 
anywhere on the disk with each block of data having a pointer to the block that 
logically follows. 

5.2*2 Direct File Format 

A direct file contains binary data with fixed length records and fixed number of 
records. This format is used by user programs, generally for master type data. 

A direct file is accessed randomly by relative record number. This means that any 
record may be accessed independently of all other records in the file. To access a 
specific record the only information required is its record number, relative to the 
start of the file. 

The size and record length of a direct file must be known when the file is first 
created. A direct file is created by using the CREATE program. 

5.2.3 Indexed File Format 

OASIS supports a single key, hashed, sequential access file format called indexed. 
Similar to the direct file, an indexed file contains fixed length records, fixed 
allocation file size. 

An indexed file is accessed randomly or sequentially. The only information 
necessary to access a specific record is the key that it was written with. 
Normally this key is logically associated with the record such as a customer name 
for a customer record, part name for an inventory record, etc. The key may be up 
to 128 characters in length but the maximum length must be known when the file is 
created with the CREATE program. 

The combination of indexed access and sequential access allows you to simulate 
"approximate or generic key match" access. Approximate match means that the key 
field of the record accessed may be equal to or greater than the specified key. 
Using an index, it is often desirable to access the record that contains the key 
value requested, or the record with the next highest key value if the requested key 
value doesn't exist in the file. This allows a user program to retrieve records 
without knowing an exact key and without repeated access operations when the system 
does not have the record specified by the key. 

An indexed file can be read sequentially in key sequence. This makes this file 
format very useful for many applications in which the information is updated 
randomly but is required to be listed in sequence. 

An indexed file is always maintained by the system in sequence. There is no 
"overflow" area to be sorted periodically. 

5.2.4 Keyed File Format 

Keyed files are identical to indexed access files without the capability of 
maintaining the keys in sorted order. The file can be accessed ranodomly by key or 
sequentially by key but the sequence that the records are accessed in appears 
randomly ordered; the sequential access capability merely allows you to access all 
of the records in the file without knowing the specific keys of all of the records. 
Keyed access files offer much quicker access times for writing new records. 

5.2.5 Absolute File Format 

Absolute files are generated by the system linking loader and are restricted to 
machine code programs. These files contain programs in a "memory image" format 
which is a "picture" of what memory will look like when a program is loaded. The 
file itself requires the same amount of disk storage as the corresponding number of 
256-character memory blocks. 

5.2.6 Relocatable File Format 

Relocatable and self-relocatable files are also generated by the system linking 
loader and are restricted to machine code programs. A relocatable file is origined 
at address zero. When the program is run (by entering the program name at the CSI 
level), the file is relocated as it is loaded into memory. (An absolute file 
requires no such relocation.) A self-relocating program is also origined at zero. 
The programmer has the responsibility of using a special system subroutine before 
each reference to an absolute address. This system subroutine (referred to as a 
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system call) adjusts the address reference, 

5.3 File and Disk Protection 

In many applications for computers it is desirable that there be some means of 
preventing the inadvertent alteration of stored information. The user may wish to 
prevent programming errors from changing master files or he may wish to prevent 
operator errors. The OASIS file management system provides this means. 

Any specific data or program file may be protected from erasure, alteration, or 

both. This protection is specified to the system by using the RENAME program. By 

using this program you can delete protect, write protect or read protect a file or 
group of files. 

Delete protection will not allow any program to erase the file. 

Write protection will not allow any program to make changes to existing records in 
the file or to add new records to the file. A file that is write protected is not 
necessarily delete protected. 

Read protection will not allow any program to access the file (writing to a file 
requires that part of the file first be read) , with the exception of BASIC programs 
accessed by the RUN command. 

In addition to this specific protection the system provides a means of protecting 
an entire disk of information from being altered in any way. To write protect an 
entire disk the INITDISK program is used. 

When a disk is write protected no file on the disk may be deleted or changed by any 
program. 

5.4 Program Protection 

System programs may be protected from unauthorized execution by means of a 
privileged access method. All of the system programs have a privilege value 
associated with them. The system has a privilege level associated with it. Any 
attempt to execute a program whose privilege value is greater than the current 
system privilege level will be ignored. The operating system is distributed with 
the highest privilege level available (5), thus allowing access to all of the 
distributed programs. The privilege level of the system may be lowered, thus 
restricting access to programs with a privilege value higher than the value that is 
set. 

The privilege values for the system and the system programs may be changed by using 
the CHANGE command. This allows you to set your own levels of access. The 
privilege level of the system is a SYSGENable function, allowing you to 
"permanently 11 set the level of access. The appendix on Privilege Levels defines 
the methods of changing the privilege levels and values and defines the values of 
the programs, as distributed. 

5.5 Multi-user File and Record Locking j 

! 

A feature available with multi-user OASIS is entire file locking or individual j 
record locking. When a file or record is locked by one user other users are denied 
access to that file or record until the user that has locked the file or record 
unlocks it. j 

i 
This feature is very necessary for the prevention of bad data. Without file or j 
record locking user one would be able to read a record, user two could also read 
that same record, change it and write it back without user one knowing that the 
record he has is no longer current. j 

i 
File and record locking is easy for the user to specify — see the OASIS BASIC } 
Language Reference Manual and the OASIS MACRO Assembler Language Reference ManualT ^ j 

i 
Caution: Deadlocking may occur if care is not taken when programming an application ! 
in a multi-user environment. A deadlock is when a user»s processing is suspended 
for an excessive time due to the careless locking of a record or file by another 
user partition. ! 
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SYSTEM CONYEHTIOffS 

OASIS system conventions such as file naming procedures, prompting characters, etc* 
are described in this chapter. You should be familiar with these conventions 
before running the system. 

6.1 Directory Search Criteria 

When OASIS is capable of using two or more file directories, a problem of search 
order arises. If, in a specific program, you specify which directory to examine 
for the file, there is no doubt as to where and how to search directories. In some 
cases you do not or cannot designate a directory. In this situation there must be 
a set search sequence for scanning directories to find a specified data file or 
available disk space. 

Standard Search Order 

To find a data file or user program (not a user written command), user disks are 
searched in the system-defined alphabetical order? A, B, C, D, E, F, G, S. 

To find a command or EXEC program the system disk is searched first and then the 
user disks? A, B, C, D, E, F, G. 

To find space for creating a new data file the system disk is searched first and 
then any user disks. 

6«2 Prompting Characters 

The OASIS operating system uses different prompting characters for each of the 
programs that accept input from the keyboard. This provides an easy means of 
determining which program is asking for input. The following table summarizes the 
characters displayed by each program to indicate to the user that the system is 
awaiting user response. 

> The Command String Interpreter is waiting for a command. 

• TEXTEDIT or EDIT is waiting for a command. 
- BASIC is waiting for a command. 

? A BASIC program is waiting for input. This prompt can be changed by the 
user program. 

: An EXEC program is waiting for input. 

= The system DEBUG program is waiting for a command. 

A system program has displayed a full screen of data and is awaiting a 
response to indicate that it may proceed, to the next screen. 

\ The PATCH program is waiting for a command. 

) The COFYFILE program is waiting for input to the translation list. 

~ The COFYFILE program is waiting for input (only when from file is CONSOLE)-. 

# The LINK program is waiting for input. 

6.3 File Naming Conventions 

Each file created by the system or by a user program is referenced by a file 
description. The description consists of three elements in the following format: ~ 

filename. filetypeifiledisk 

filename Is a one to eight character alphameric name assigned (in most cases) by 
the user. The first character of a file name must be a letter. The name 
may only contain letters, digits, or a dollar sign. 

f iletype Is a one to eight character alphameric name used as a descriptor or 
qualifier of the filename. Certain filetypes have special meaning to 
OASIS and should be used accordingly. The first character of the file 
type must be a letter and only letters, digits, or dollar signs may be 
used for the other characters. Imbedded spaces are not allowed in file 
names or types. 

filedisk This may be either the directory label of the disk or the disk label of 
the disk on which the file resides. 

Most of the programs in OASIS allow the file disk specification to be 
omitted. In this situation the system will search the disks for the file, 
stopping on the first occurrence of the file name and type. 
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The OASIS operating system has several reserved file descriptions: 



IPL.EXEC 

SYSTEM. NUCLEUS :S 
SYSTEM. CSI:S 
SYSTEM. EXECnrS 
SYSTEM. DEVN AMES :S 
SYSTEM. ACCOUNT: S 
SYSTEM. HISTORY :S 
SYSTEM. ERRMSG:S 
SYSTEM. EXEC :S 
SYSTEM. SPOOLER :S 
SYSTEM. SPOOL$$n 
SYSTEM. DEVnn:S 
SYSTEM. CLASSnn:S 



- system start-up procedure. 

- the "core" of the operating system. 

- the Command String Interpreter. 

- working storage for executive procedures. 

- physical device names and attributes. 

- user accounting name, passwords, and privilege levels. 

- user accounting history, etc. 

- error numbers and messages. 

- EXEC language processor, 
-print spooler program. 

- spooled print files. 

- Device drivers. 

- Terminal class code translators. 



These file desciptions should not be used for any function other than as provided 
when the operating system is distributed. 



Additionally, there are several 
various OASIS commands: 



file types that have special or default uses by 



ASSEMBLE 

BACKUP 

BASIC 

BASICCOM 

BASICOBJ 

BASICUSR 

C 

COBOL 

COMMAND 

COPY 

EXEC 

FORTH 

FORTRAN 

LINK 

LOADFILE 

MACLIB 

MACRO 

OBJECT 

PASCAL 

SCRIPT 

SYNONYM 



ype for the MACRO assembler 
EDIT/TEXTEDIT as a copy of the input file. 



Default file t; 

Required by ED . ..___. 

Default file type for a ASCII, BASIC program 



& 



Required file type for the BASIC runtime monitor (RUN). 

- Required file type for the BASIC interpreter. 

- Required file type for a BASIC assembly language subroutine. 

- Default file tpe for the C language processor. 

- Default file type for a COBOL language processor. 



- Required by all commands that are executed by CSI. 

- Default file type for the MACRO assembler, copy files. 

- Required file type for the EXEC language processor. 

- Default file type for the FORTH language processor. 

- Default file type for a FORTRAN language processor . 

- Default file type for a LINK" control file. 
-Default file type for a re-entrant, loaded program. 

- Required for a library file of macro definitions. 

- Required file type for the MACRO assembler, macro definition. 

- Required by the LINK command for its input files. 

- Default file type for a PASCAL language processor. 

- Default file type for the SCRIPT processor. 

- Required file type for a command synonym table. 



These file types 
purposes. 



must be used when indicated and should only be used for the above 



The file description SYSTEM. WORK$$n is used by the system for work files. Avoid 
using this file type as your file may be erased by the system when it wishes to use 
a work file by the same name. 

The file name of HELP should be not be used for data files or high level language 
program, names as this name is reserved to indicate that a "help" message is to be 
displayed about the program. 

6.4 Wildcard Specifications 

Some of the commands allow you to specify more than 
instance, the FILELIST command allows you to specify a 
disk, or all files with a specific name or type. In 
features the system allows you to specify all files 
character or string of characters, etc. 



one file at a time. For 

list of all files on one 

addition to these general 

starting with a specific 



The following definitions and examples illustrate the various ways that a file name 
or type may be specified. These features are only permissible when the command 
allows you to specify more than one file. This way of specifying a file 
description is referred to as "Wildcards". 
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Wildcard Definition 



Indicates that any characters from this position through the end of 
field are acceptable. 

Indicates that any character in this position is acceptable. 

Indicates that any alphabetic character in this position is acceptable. 

Indicates that any numeric character in this position is acceptable. 

Indicates that the source file description for this element is to be used 
for this character position through the end of the field. This wildcard 
is only available in the COPYFILE and RENAME programs. 



Examples! 

* BASIC S 

This file description 
are to be included. 

GLUP* B??????# S 



indicates that all files whose type is BASIC on the S disk 



This file description indicates that all files whose name starts with the 
characters GLUP, whose type starts with the character B, has a number in the eighth 
position and is on the S drive are to be included. 

§§§§??#* ?? * 

This file description indicates that all files should be included whose name is at 
least seven characters long, of which the first four characters are alphabetic, the 
next two may be any character, the seventh character is numeric and the eighth 
character may be anything, including a space. The type must be two alphameric 
characters only and the file may be on any disk. 

6.5 Hunerle Paraneters 

Some of the commands discussed in this manual allow certain parameters or options 
to be numeric. The system allows these elements to be entered using either numeric 
base ten (decimal) or base sixteen (hexadecimal) . Decimal numbers are entered 
using only the digits 0-9. Hexadecimal numbers are entered using the digits 0-9 
and characters A-F with the first character numeric and the number is terminated 
with an H. Examples of hexadecimal number entry are 14AFH and OFFFFH. 

6.6 HELP Function 

When you first start using the system you will be unfamiliar with the command 
syntax of the various commands in the system. As an aid to the beginning user (and 
for those commands that are infrequently used) all of the OASIS commands have a 
HELP function available to them. 



reason, you are unsure of the command syntax or options available 

HELP followed by a space and the fully spelled command name for 

which the help information is required. The command will display the following 

information: 



If, for whatever 
use the command 



* General function of the command. 

* Syntax of the command. 

* Options and functions available with the command. 
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HELP Example: 

>HELP ATTACH 



Function: To map a logical device to a physical 

device, or to unattach a logical device, 
or list current attachments. 

Syntax: ATTACH log [phy [(options)]] 



Where : 
log 

Phy 



Options: 
Lnnn 
Pnnn 
Bnnn 
Cnn 
LFnnn 
FFnnn 
PE & PO 
ENABn 
PP 

Onnn 
W8 

SYNC 
SDLC 
ALF 
Hnnn 
Rnnn 
STPnnn 
STSnnn 
PUBLIC 
WAIT 



CONSOLE. PRINTERn, READER 
PUNCH, COMMn,TAPEn. drive 
Are the names defined in 
SYSTEM. DEVN AMES :S 



line width for con,prt 

page depth « n « 

baud rate for SIO 

Class for console or printer 

Line Feed delay for SIO 

Form Feed delay for SIO 

Parity Even or Odd for SIO 

Handshake ( 1 =DTR , 2=DC 1 /DC3 , 3 =ETX/ ACK , 4=CTS ) 

maintain Page Parity for PRT 

size of Overflow margin for PRT 

word length 8 for serial device 

synchronous mode for serial device 

bit protocal mode for serial device 

Auto Line Feed for PRT 

Head load delay (msec) 

Disk retry count 

Track step time (msec) 

Step settle time (msec) 

Mark as public device 

Wait for device to become available 



6.7 Fons Alignment 

The OASIS operating system always assumes that the forms in a listing device are at 
top of form and that the printing mechanism is at the left hand side of the page. 

Whenever an OASIS program uses a listing device the program will always close the 
device with the forms at the top of form position and the printing mechanism at the 
left hand side. Any user written programs should also follow this convention for 
consistency. 

6.8 Program Return Code 

The system return code (displayed when RDYMSG set on) is. a numeric value that,, in v 
general, indicates whether the previous program was executed to completion and 
whether it was successful. This code is very useful when programs are executed 
from an EXEC program or during testing of a new program. . 

There are seven specific return codes used by OASIS system programs. User written 
commands should conform to these return codes for consistency. (The return code is 
set by loading register A with the value immediately before returning control to 
the operating system.) 



Program Return Codes 



RC 

""5 

4 

8 

12 

16 

253 
254 



Meaning 



Normal job completion. 

Warning errors encountered. 

Syntax errors detected in command line. 

Severe error detected (file not found, etc.) 

Potentially disastrous error detected (disk/system integrity 

may be suspect) . 

Fatal, run- time error during RUN command. 

Program canceled by operator using System Cancel-key. 
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SYSTEM CONTROL KEYS 

OASIS has twelve control keys defined for special use in controlling the system* 
The functions of the keys are such that you may wish to use them while a program is 
in operation. These - keys may only be entered from the device attached as the 
console keyboard. The first seven of these keys will clear the type-ahead buffer. 

7.1 System Restart-key 

This key will cause the operating system to quit the current program in execution 
and cause the system to "re-boot". This key takes action immediately upon entry. 
Caution should be exercised in the use of this key as any open disk files that are 
being updated will not be closed. Any open files may then be logically invalid. 
The message "OK to IPL?" is displayed following the entry of this key. You must 
respond with a Y to actually perform the restart* 

j The System Restart-key is not available on multi-user OASIS as it could cause [ 
! disastrous results. I 

7.2 System Cancel-key 

This key will cause the operating system to quit the current program in execution 
and return control to the next higher level of program. Normally the next higher 
level is the operating system itself but in some cases a program may be executed 
from the Executive language. In this case the system will ask you "Cancel EXEC 
(Y/N)? n . Answering with an N will cause the current program to be cancelled but 
control will return to the EXEC program. Answering with a Y will cause the EXEC 
program to be exited also. 

When this key is entered a "clean" abort is performed: open file buffers are 
written to the disk file and files are closed. 

Whenever this key is entered three of the toggle type keys will be reset: Printer 
Echo-key is set off; Console Echo-key is set on; Program Pause-key is set off. 



This key is a toggle type key. that is, entry of the key once causes the function 
to start, entry of the key again causes the function to 



7 .3 Printer Echo-key 

type kev. that is. entry of the h 

stop. The function of this 
key is to cause all characters output to the console to be displayed on the primary 
listing device. When the system is first started the status of this key is "off". 

7*4 Console Echo-key 

This key is a toggle type key, similar to the Printer Echo-key. The function of 

this key is to cause all characters output to the console to be displayed or not 

displayed on the console. When the system is first started the status of this key 
is "on". 

7.5 Program Pause-key 

This key is a toggle type key, similar to the Printer Echo-key. The function of 
this key causes any program currently executing to "pause". Unless the program is 
accessing the disk, entry of this key will cause the program to stop whatever it is 
doing, when the Program Pause-key is entered again the program will continue from 
the point at which it was interrupted. 

7.6 Program Cancel-key 

The function of this key is program defined and most programs ignore it. However a 
few of the OASIS commands do use it. For example, BASIC uses it to stop the 
execution of a program and return to its command mode; RUN uses it to to set a 
testable error (the application program can then do whatever it wants); DEBUG uses 
it to abort a command in progress ana return to its command mode; SCRIPT uses it to 
allow you to abort the printout after the completion of the current page. 

7.7 Debug Break-key 

Entry of this key causes a "break-point" immediately. It is only effective if the 
system debugger has been loaded. If the debugger is loaded the program counter 
will be displayed and control will be transferred to the DEBUG environment. 

7.8 Line Cancel-key 



Entry of this key causes the current line of input to be ignored. Most programs, 
upon recognizing this key, will erase the characters being ignored. 
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7*9 Character Delete-key 



Entry of this key causes the last character entered from the keyboard to be 
deleted. For consoles whose class code is not zero this deletion is performed by 
physically erasing the character from the screen with a backspace, space, backspace 
sequence. 

7*10 Console Display-fast 

This key "backs out" one Console Display- slow key until the output to the console 
is at its maximum speed. 

7.11 Console Display-slow 

Entry of this key causes the display to the console output device to be slowed down 
by delaying the output process after each character is output. 



Entry of this key the first nine times will add one millisecond between the display 
of each character. Entry of this key the next ten times will add one hundreth of a 
second between the display of each cnarcter, etc. 

The console output rate set by these two control keys is a SYSGENable function. 

7.12 Console Screen Wait 



This control key is a toggle command. Toggling this key on will cause the output 
to the console device to "wait" after each page is displayed by positioning to the 
bottom left-hand corner of the screen, displaying an up-arrow (*), and waiting for 
the operator to type a key. When the operator has typed a space or return key the 
output to the Console continues with the next page. 

Toggling this key off will disable this "wait" feature. 

Systea Control Keys 



j Function 


Key sequence 


System Restart-key * 


ESC, I * ! 


System Cancel-key 


ESC,Q 


Printer Echo-key 


ESC,P 


Console Echo-key 


ESC,0 


Program Pause-key 


ESC,S 


Program Cancel-key 


ESC,C 


Debug Break-key 


ESC.D 
CTRL/X 


Line Cancel-key 
Character Delete-key 


left-arrow 


or 


CTRL/H 


or 


DEL 


or 


RUB 


Console Display-fast 


ESC, A 


Console Display-slow 


ESC,B 


! Console Screen Wait 


ESC,W J 



* Single-user OASIS only. 

Control Keys 

When a reference is made to a control key or key sequence the key will always be 
defined in a consistent manner: 

1. Keys that need to be entered in sequence will be separated by commas; 
for example: ESC,Q means that the escape key is typed followed by the 
f Q f key. 

2. Keys that need to be entered simultaneously will be separated by 
slashes; for example: CTRL/ SHIFT/ A means that the three keys control, 
shift, and 'A' must be typed simultaneously. To accomplish this it is 
easiest to type and hold the control key, and while the control key is 
still held down type and hold the shift key, and while both of these 
keys are held down type the 'A* key. 
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CHAPTER 8 

D0CUMHITATI08 COHVEHTIONS 

The notations used to define the command syntax in this and associated manuals are 
defined in the following paragraphs. 

Truncation and Abbreviation of Co— lands 

When abbreviation of a command is permitted, the shortest acceptable version of the 
command is underscored. To determine the acceptable abbreviations refer to the 
chapter n SHGW Command", SYNONYM function. The example below shows the format 
specification for the COPYFILE commando 

&OPYFILE 

This representation means that C, CO, COP, COPY, COPYF, COPYFI, GOPYFIL, and 
COPYFILE are all valid specifications for this command name. 

Command options are specified in the same manner. Where abbreviation is permitted, 
the shortest acceptable form of the option is underscored. If no minimum 
abbreviation is indicated, the entire word must be entered. 

Special Documentation Characters 

The following symbols are used to define the command format and should never be 
typed when the actual command is entered. 

vertical bar | 
brackets [ ] 
ellipsis ... 

Additionally, angle brackets (<>) are used to enclose a term denoting that that 
term is to be replaced with one or more specific terms. For example: <fd> is 
replaced with the specific directory label or disk label such as — A, B, S, DATA1 , 
etc. 

Special Characters for OASIS 

Uppercase letters and words, and the symbols listed below, should be typed as 
specified in the command format. 

asterisk * 

comma , 

equal sign = 

parentheses ( ) 

period 

colon : 

Other characters 

Lowercase letters, words, and symbols that appear in the command format represent 
variables for which specific information should be substituted. For example, 
"file-desc" indicates that file identifiers such as "MYFILE.EXEC.-A" should be 
entered. 

Co— mils with Choices 

Choices are represented in the command formats by stacking or separation with the 
vertical bar. 

A ON! OFF 

B 

C 

Brackets 

The use of brackets denotes optional choices, one of which may be selected. 

For example, the representation 

A 
B 
C 

indicates that the user may code A, B, or C, or he may omit the field entirely. 
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Ellipses 

An ellipsis indicates that the preceding item or group of items may be repeated 
more than once in succession. 

For example, the representation 

(<option>...) 

indicates that more than one option may be coded within the parenthesis. 

Abbreviations Used 

The following abbreviations are used throughout this manual and when used will 
always have the meanings defined here. 

Abbreviation-Meaning 

file-desc File description. Indicates that the file name, file type and file 
disk are to be inserted here. 

fn File name. 

ft File type. 

fd File disk label. Indicates which disk contains the file. The disk 
may be identified by either the label that is ATTACHED to the 
directory or the label written on the disk by the INITDISK command. 
This parameter is normally optional. 

ch Input/ Output channel. 

drv Disk drive number such as 1, 2, 3, ETC. 

pin Partition identification number. Indicates the number of the memory 
partition associated with a user. 

fr From. Usually used in a command that allows a from - to range to be 
specified. 

n A lowercase n or group of n's indicates that the operator may type a 
number. This number may be entered in decimal or hexadecimal (see 
section on Numeric Parameters) . 

Naming Conventions 

All command names, file names, file types and options must meet the following 
requirements : 

a. All characters must be alphabetic, numeric or the dollar sign $. 

b. The first character must be a letter or dollar sign character. 

c. The length of each field may not exceed eight characters. If the 
field exceeds eight characters, the extra characters are truncated 
without any indication to the user. 
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CHAPTER 9 
THE CGMfABD STRING INTERPRETER 

9.1 The CSI Prompting Character 

The Command String Interpreter (CSI) accepts input from the system keyboard and 
transfers control to the various command programs. The CSI is in control 
immediately after a system boot and its control is indicated by a prompting greater 
than character (>) at the left side of the screen. 

9.2 CSI Format 

An OASIS command, as seen by the CSI, consists of a command name, usually followed 
by one or more positional operands and, in some cases, by an option list. The 
general form for the command is: 

command name [operand ...] [(option ...[)]] 

You must use the proper delimiters to separate the entries in the command line^ 

These delimiters are - a period or space before a file type; a colon or space 

before a file disk: a left parenthesis before the first option; a comma or space 
before all other entries. 

9.3 The Command Name 

The command name is an alphabetic symbol of not more than eight characters. In 

general, the names are English verbs which describe the function you want the 

system to perform. For example you may wish to make a backup of a disk. In this 

case you would use the BACKUP command. Or you may want to list a file on the 

system- printer. To do this, you would use the LIST command with the option PRINT. 

9.4 The Cr—nnrt Operands 

The command operands are keyword and variable symbols no longer than eight 
alphameric characters. These keywords and variables specify the information on 
which the system operates when it performs the command function. In the LIST 
command, you would use the file name and file type operands to specify the file to 
be listed. 

Some commands require no operands, others require several. The command syntax and 
all operand requirements are specified in the following chapters. 

You must enter the operands in the order in which they appear in the command 
formats, unless otherwise indicated. 

9.5 The Command Options 

The command options are keywords used to control the execution of the command. The 
command formats in the following chapters show all the options for each command. 

The option list must be preceded by a left parenthesis - a closing parenthesis is 
not necessary. 

If conflicting or duplicate options are specified, the last option entered is the 
option in effect for the command. Exceptions to this rule exist in the COPYFILE 
and INITDISK commands. 

9.5.1 Default Options 

To specify that you want the default options for a command, enter the command name 
and operand. It is not necessary to enter the left parenthesis unless you wish to 
include some of the non-default options. 

9.5.2 Convents in the CSI 

You may enter comments with OASIS commands by preceding the comment with the 
semi-colon character ( ; ) . The Command String Interpreter ignores all characters 
after the semi-colon, including the semi-colon. 

9.6 CSI Program Search Sequence 

The Command String Interpreter has a predetermined search sequence when it is given 
a command to search for. When you type a command the CSI will search for the 
command program in the following sequence: 

1 . Search the system disk for a program with the same name as that 
entered, and file type COMMAND. 
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2. If ABBREV is set ON then search the system abbreviation table for a 
match between the spelling of the command typed and the full command 
name. When a match is found step 1 is repeated. 

3. If a user SYNONYM table has been defined then search the user synonym 
table for a match with the user synonym and, if ABBREV is also ON, 
the abbreviation specified in the table. If a match is found step 1 
is repeated. 

4. If IMPEXEC is ON then the system disk is searched for a file with the 
name as typed and a file type of EXEC. If a file is found the 
EXECutive procedure processor is invoked to interpret the commands in 
the EXEC file. 

5. If ABBREV is set ON and a user SYNONYM table has been defined then 
step four is repeated using any matching abbreviations found in the 

X (Xi «L> *§ © 

of the attached disk 



The above five steps are repeated for each 
drives, in ascending, alphabetic sequence. 

If no command program or • EXEC has been found the CSI will display an 
error message. 



Once a program file has been identified 
system is transferred to this program. 

9.7 CSI Calculator 



and loaded into memory, control of the 



Incorporated into the Command String Interpreter is an integer Reverse Polish 
Notation (RPN) calculator. This calculator is available to the operator when the 
CSI prompt character is displayed. To use the calculator merely enter the RPN 
instruction following the prompt. For example: 

>123 456 + 

Hex = 0243 , Dec = 579 

As can be seen the answer is displayed in hexadecimal base and decimal. Operands 
to the calculator may be entered in decimal or hexadecimal (use trailing H) but the 
operand must start with a digit (0 - 9). Operators to the calculator include: + - 
* / \ & ! * - #. These operators perform the following respective operations: 
addition, subtraction, multiplication, division, modulo. logical AND, logical OR, 
logical XOR, unary one's complement, and unary two's complement. 

Any number and combination of operands and operators are allowed. Incomplete 
operations or partial results are stacked with the stack size being limited only by 
available memory. The stack is maintained only until a valid OASIS command is 
executed. The current contents of the stack may be displayed by typing a question 
mark. 

9-8 CSI Functional Summary 

The following tables present a functional summary of the commands available to the 
OASIS user. They are described in detail in the following chapters. 



Cr— iiimI ii for Disk Maintenance 



Command Function 



ARCHIVE Archive a file, account, or disk. 

BACKUP Copy an entire disk. 

INITDISK Initialize a disk for use by OASIS. 

INITTAPE Initialize a tape for use by OASIS. 

RECOVER (Optional) Find and restore a file to it's directory. 

REPAIR (Optional) Detect and correct disk mis-allocation. 

RESTORE Restore from archive a file, account, or disk volume. 
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CHAPTER 9: THE COMMAH) STRIBG INTERPRETER 
Commands for File Maintenance and Control 



ASSIGN Make I/O channel assignments. 

ATTACH Logically connect a device for future access. 

COPYFILE Copy one disk file to another disk file. 

CREATE Create a new file with direct or indexed format. 

DUMPDISK (Optional) Display the physical contents of file in hexadecimal and ASCII. 

EDIT (Optional) Create or update a file from terminal input. 

ERASE Delete an existing file. 

FILELIST List the names and attributes of the files in a directory. 

GETFILE (Optional) Transfer a sequential file from a non OASIS compatible disk. 

KILL (Optional) Remove a file from the directory without deallocating its 

space. 
LIST Type the contents of a file on a console or printer. 
MOUNT Allow a disk to be changed. 
PEEK Peek at another users console output. 
RENAME Change the name, type, or protection status of a file. 
SECTOR (Optional) Display sector numbers used by a file. 
SORT (Optional) Sort a disk file into specified sequence. 
STATE Determine the existence of a file. 
TEXTEDIT Create or update a file from terminal input. 



Ccriruidij to Develop and Maintain Programs 



Command Function 



BASIC (Optional) Create or update a BASIC source program. 

DEBUG (Optional) Dynamic debugger for machine language programs. 

EDIT (Optional) Create or update a source program. 

FILT8080 (Optional) Translate Intel assembly mnemonics to Zilog mnemonics, 

compatible with the OASIS MACRO Assembler. 
INTELHEX (Optional) Convert Intel object code to OASIS object code. 
LINK (Optional) Translate with editing, an object program file to a load image 

(COMMAND) file. 
MACRO (Optional) Translate an assembly language source program to an object 

program. 
PATCH Correct minor problem in a load image file (COMMAND) program. 
RELOCATE (Optional) Create a relocatable object file from two absolute object 

files. 
TEXTEDIT Create or update a text file. 



Cnmminrt i to Change OASIS Parameters 



Command Function 



ACCOUNT Maintain user account names and attributes. 

CHANGE Change the privelege value of a program. 

LOAD Load a re-entrant command for subsequent usage. 

OWNERCHG Transfer ownership of a file to another account. 

SET Enable/disable various system switches. 

SHARE Enable/disable shared access to file by other accounts. 

SHOW Display the status of various system switches and parameters. 

SPOOLER Change or display status of the printer spooler. 

START Initialize a user partition and allow user to logon. 

STOP Deinitialize a user partition. 

SYSGEN Save status of OASIS parameters on disk. 

UNLOAD Remove a re-entrant command from memory. 



Commands for System Diagnostics 



Command Function 



MEMTEST (Optional) Diagnose memory. 

SEEK (Optional) Test random sector reading of a disk. 

VERIFY (Optional) Test readability of a disk. 
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Commands to Execute Programs 

Command Function 



BASIC (Optional) Execute a BASIC program. 

EXEC Execute an EXEC program. 

FORCE Cause another user partition to execute a command. 'I 

RUN (Optional) Execute a BASIC compiled program. 



Cn—iinrtu for Systea Conunieatlons 

Command Function 

BISYNC~~~imulate~functions^^^ ~~ I 

MAILBOX Retrieve message sent by other users. 

MSG Send a message to another user(s). ! 

RECEIVE (Optional) Accept and save a file from another system. 

SEND (Optional) Send a file to another system. 

TERMINAL (Optional) Cause system to act like a terminal to another foreign system. 
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ACCOUNT COMMAND 

The ACCOUNT command provides the ability to maintain the SYSTEM. ACCOUNT file. This 
file is special in the sense that it doesn*t belong to any account and can only be 
maintained by this command. The format of the ACCOUNT command is: 

ACCOUNT [(optlonC)]] 

As is seen, this command format is different from other command formats in that no 
file description is allowed. 

IMPORTANT: USE OF THIS COMMAND IMPLIES CERTAIN RESPONSIBILITIES. BE SURE THAT YOU 
UNDERSTAND THE CONSEQUENCES OF DELETING, ADDING, OR CHANGING ACCOUNTS BEFORE USING 
THIS COMIAND. 

ACCOUNT Options 

TYPE Indicates that the current SYSTEM. ACCOUNT file is to be displayed on the 
console. 

£RINTER[n] Indicates that the current SYSTEM. ACCOUNT file is to be displayed on the 
primary printer or PRINTERn if n is specified. 

CLEAR Indicates that the account history file (SYSTEM. HISTORY) is to be 
transferred to the public file ACCOUNT. HISTORY. Any previous 
ACCOUNT. HISTORY file owned by the system will be erased. 

HISTORY Indicates that the current SYSTEM. HISTORY file is to be displayed on the 
console (default) or the printer if the PRINTER option is also specified. 
The listing of the history file includes the following information: time 
and date of entry, entry type, account name, account number, partition 
identification number, and elapsed time. Refer to the appendix "System 
Files" for more information about the SYSTEM. HISTORY file. 

KILL Indicates that the user accounting feature of the system is to be 

disabled. When this option is selected two questions will be asked of the 

operator. These questions must be answered correctly for the accounting 

feature to be disabled. 

The user accounting feature is disabled by physically removing certain key 
programs and files from the system disk. Once this nas been done the user 
accounting feature cannot be re-enabled without changing to an archive 
copy of the system. 

This option should be used with great discretion for another reason: any 
accounts active in the system (files or programs owned by accounts other 
than the system) will be inaccessible after the accounting feature is 
KILLed. To avoid this situation you must use the OWNERCHG command to 
transfer ownership of the active accounts files and programs to the 
system account. The SHARE command must also be used to remove any shared 
file access. 

The two questions asked by this option are: 

Do you wish to remove the accounting feature? 

Do you ever wish to use the accounting feature again? 

The first question must be answered with a Y and the second question must 
be answered with a N before the accounting feature will he KILLed. 

C0PY=fd Indicates that the current SYSTEM. ACCOUNT file is to be copied to the disk 
on the drive specified by fd. This is an easy means of transferring an 
accounting structure to another system disk. 

When no option is specified in the command line the account maintenance option of 
the command is invoked. This maintenance option allows for the addition, deletion, 
and changing of account names, passwords, and privilege levels. 

When the ACCOUNT command is in the maintenance mode the program is interactive. 
The specific maintenance mode is determined by the operator f s answer to the 
question: 

Mode (Add/Change/Delete/End)? 

Answer this question with the appropriate letter: A for adding an account, C for 
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changing an existing account, D for deleting an existing account, or E for ending 
the maintenance session. 

The add, change, and delete modes all ask for the account name to be specified. 
When the mode is add the account name entered must not be on file. When the mode 
is change or delete the account name must be on file. 

Add Mode 

In the add mode the program asks if the new account is to be a synonym to an 
existing account. If it is then enter the existing account name that it is a 
synonym to. Synonyms to existing accounts mean that the synonym account has access 
to all of the files that the primary account has access to. A synonym account has 
its own password and privilege level associated with it. 

If the new account is not to be a synonym of an existing account then enter a 
carriage return only in response to the synonym question. Whether or not the new 
account is a synonym to an existing account the program will ask for the password 
to be associated with the new account. The rules for the composition of a password 
are the same as for file names. If the new account is not to be password protected 
then do not enter a password. 

Next the program asks for the privilege level associated with the account. The 
privilege level is a number in the range of 0-5 but you are only allowed to specify 
privilege levels less than or equal to your current privilege level. 

After the above information is entered the program returns to the Mode question. 

Change Mode 

The change mode of maintenance allows the operator to change the current password 
and privilege level associated with an account name. To delete the password type 
the number sign character (#) in response to the password question. 

Delete Mode 

The delete mode will remove the account name specified from the SYSTEM. ACCOUNT file 
and return to the Mode question. 

Care should be exercised when deleting an account name. The system maintains 
accounts not by name but by a number that it assigns to new accounts. When an 
account is deleted any files it may have had will not be accessible. If a deleted 
account is later re- added it will probably be assigned a different number than it 
had previously and the files will still be un-accessible. (In fact, it is probable 
that a completely different account name will be added at some time that is assigned 
the same number by the system. When this happens any files still in the system 
with the old deleted account's number will suddenly belong to the new, unrelated 
account.) 

Therefore it is advised that before deleting an account a check should be made to 
see if that account owns any files. If so the files should be transferred to 
another account with the OWNERCHG command or erased from the system. 

It is okay to delete an account if a synonym to that account still exists (synonym 
accounts are accounts with the same number out a different name) . 

End Mode 

During the maintenance session all additions, changes, and deletions are kept 
internally to the program. To cause the SYSTEM. ACCOUNT file to be updated with the 
changes the END mode is used. If. instead, the System Cancel-key is entered none 
of the additions, changes, or deletions will be made to the file. 

Examples 

>ACC0UNT 

Mode (Add/Change/Delete/End)? A 

Account name? PRIVATE 
Synonym name? 
Password? SUPERMAN 
Privilege? 3 
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Mode (Add/Change/Delete/End)? A 

Account name? STARTREK 
Synonym name? PRIVATE 
Password? KIRK 
Privilege? 

Mode (Add/Change/Delete/End)? D 

Account name? STARWARS 

Mode (Add/Change/Delete/End)? C 

Account name? PRIVATE 
Password? # 
Privilege? 

Mode (Add/Change/Delete/End)? E 

>ACC0UNT (TYPE) 

Account Password Priv Id 



IPL 










PRIVATE 




3 


2 


STARTREK 


KIRK 





2 


SYSTEM 




3 


1 



In the above example session the account PRIVATE is added with a password of 
SUPERMAN, and a privilege level of 3. Next a synonym is added by adding the 
account STARTREK as a synonym of PRIVATE. This synonym has the password KIRK and a 
privilege level of 0. This synonym account will be able to access all of PRIVATE* s 
files (and vice versa) but, because of its lower privilege level, will not be able 
to access all of the programs in the account or in the public account. 

Next the account STARWARS is removed from the system. This will have no effect on 
any synonyms that STARWARS may have had. Finally the password for the account 
PRIVATE is removed. 
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The ARCHIVE command provides the ability to make archive copies of a file, group of 
files, entire account, or disk volume onto another disk or set of disks. This 
command is the only way of making an off-line copy of a file that is too large to 
fit on one volume of your removable media. The format of the command iss 

ARCHIVE [<fn> <ft>] <fd1> <fd2> [(options [)]] 

Indicates the file name to be archived (wildcards are allowed). 

Indicates the file type of the file to be archived (wildcards are 
allowed) . 

Indicates the disk drive label that contains the file(s) to be archived/ 

Indicates the disk drive label of the drive that is to receive the 
archived files. Notice that both <fd1> and <fd2> are required fields and 
that wildcards are not allowed for these parameters. <fd2> may be a tape 
drive if your system supports them. To specify this in place of a disk 
drive label use the logical device name TAPE, TAPE1 , TAPE2, etc. 



Where ; 

<fn> 

<ft> 

<fd1> 
<fd2> 



ABGHIVE Options 



ACCOUNT 

1QLUME 

TYPE 

NQTYPE 
VERIFY 



Only files owned by the current account may be selected 
This is a default option when <fn> or <ft> is specified. 



for archiving, 



Indicates that files from all accounts on the disk may be selected for 
archiving. This is a default option when both <fn> and <f t> are omitted. 

Display the file descriptions of those files archived. This is a default 
option when the destination is a disk drive. In addition to the file 
description of the files archived the sector number that the file was 
archived to is displayed. 

Do not display the file descriptions of files archived. 

Perform read after write verification of files archived, 
default option when the destination is a disk. 



is a 



NOVE RIFY Do not perform read after write verification. 



fiUERY 



NOQUERY 



datel 



date2 



ASK 



NQASK 



The operator is asked on a file-by-file basis if the file is to be, 

included in the archive. A reply of Y is required for the file to be 

archived. A reply of N or carriage return only indicates that the file is 
not to be included in the archive. 

The operator is not asked on a file-by-file basis if the file is to be 
included in the archive. All files matching the selection criteria 
specified in the file description, the ACCOUNT, VOLUME and/or the date 
options will be included. This is a default option. 



The first date 
last update was 
archive. 



specified in the option list indicates that files whose 
on or after the specified date are to be included in the 



A second date specified after the first date indicates that files whose 
last update was on or prior to the specifed date are to be included in the 
archive. 

This option specifies that questions are to be asked of the operator 
before the archive is to begin. These questions allow the operator to 
confirm that the proper disk is being archived to the correct disk or 
tape. This is a default option. 

This option suppresses the questions that are normally asked before the 
archive starts. The purpose of this option is to allow programmers to 
design systems with their own controlled interface to the operator. 



The media used for the archive should not contain any previous files that you are 
using as the ARCHIVE command will erase and overwrite all areas on the disk 
including the directory. 



When an archive 
ABCHIVE 



is performed between a large storage device 
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and a smaller storage device such as a flexible disk the ARCHIVE command may have 
to create several volumes to hold the resulting archive. This causes ho problems 
for the ARCHIVE utility as that is its primary function. However, the user must be 
aware that this might happen as he has to have available, before the archive 
process is started, all of the volumes to be used. 

Since several volumes may comprise one archive and you may have several sets of 
archives, the labeling of each volume becomes important. Always write on the 
label: the disk archived, the date and time when the archive was performed, and the 
volume number. 

ARCHIVE Examples 

>ARCHIVE S B (NOTYPE ; ARCHIVES ALL OF S TO DRIVE B 

Source on drive S( 1 ) 
Destination on drive B(3) 
Mount volumes now - 

Source disk is labeled "SYSTEM " 
Destination is labeled "ARCHS01 w 

Okay to start archive (Y/N)? 

Selecting and sorting files 

>ARCHIVE * BASICOBJ A B (NOTYPE ; ARCHIVE ALL BASIC PROGRAMS FROM A T0~ B 

Source on drive A(2) 
Destination on drive B(3) 
Mount volumes now - 

Source disk is labeled "DATA tt 
Destination is labeled w ARCHA001 n 

Selecting and sorting files 

>ARCHIVE A B (01/15/81 NOTYPE NOASK ; ARCHIVE RECENT CHANGES 
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ASSIGN COMttlD 

The ASSIGN command provides the ability to make I/O channel assignments outside of 
an OASIS program. This means that a program can be written that is more general in 
purpose. Before the program is executed you would use the ASSIGN command to 
specify the files that the program is to use. The format of the ASSIGN command is? 

1£§XGX E<ch>i l * <file-desc>i , <deirice>iCL£Aa] 

Where j 

eh Indicates one of the I/O channels numbered from 1 to 16. 

* Indicates that all I/O channels are to affected. This specification is 
only valid with the CLEAR function. 

device Indicates one of the I/O devices available to the system. The device 
names are listed in Appendix B. The device name DUMMY is a special name 
that means that the channel is assigned but there is no input or output 
device associated with it. A program accessing the device DUMMY will act 
as though the access was performed but nothing will have been output or 
input. 

CLEAR Indicates that the I/O channel is to be unassigned. If an asterisk was 
used for ch then all channels will be cleared of assignments. 

You may use the ASSIGN command with no channels or devices specified. In this 
situation the system will display on the console all of the current channel 
assignments . 

ASS1GB Examples: 

>ASSIGN 1 FILE1.TYPE1-.A 
>ASSIGN 2 FILE2.TYPE2:A 
>ASSIGN 3 PRINTER 
>ASSIGN 4 CONSOLE 

>ASSIGN 

1 FILEl.TYPEIsA 

2 FILE2.TYPE2sA 
PRINTER 
CONSOLE 

>ASSIGN 2 OASIS.DOCUMENT.-B 

>ASSIGN 

1 FILE1.TYPE1:A 

2 OASIS. DOCUMENTS 

3 PRINTER 

4 CONSOLE 

>ASSIGN 3 CLEAR 

>ASSIGN 

1 FILE1.TYPEUA 

2 OASIS. DOCUMENTS 
4 CONSOLE 

>ASSIGN * CLEAR 

>ASSIGN 

> 
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The ATTACH command is used to associate physical device drivers with logical device 
names. This allows the operating system to be configured to the specific 

Peripherals available. Additionally, this command allows you to dynamically change 
he actual device of I/O without making changes to any programs. The format of the 
ATTACH command is J 



1XTACH [<logflev> [<pbydev> [«optloos>. ..[)]]]] 



Where : 
logdev 



phydev 



Is the logical device 
device. 



name of the device to be attached to the physical 



Indicates the 
printer) etc. 



physical device name of the device, such as CRT or LP (line 



The ATTACH command attaches physical device handlers to logical device names. 
These logical device names must be one of the names known to the system. These 
names are listed in the following tables. 

A logical device is not really a device or peripheral. It is merely a common 
communication link from an application program to a specific physical device. The 
logical device is only a pointer to the specific device's driver program and is 
accessed by using the logical device name. In this manner programs gain a great 
deal of flexibility: an application program need only reference the logical device 
name, such as PRINTER 1 , to perform input/ output: no programming is required by the 
application program to accomodate the requirements of the physical device. In this 
case the • PRINTER • may actually be a paper tape punch; tape drive, etc. 

Another attribute of a logical device is the general device class. For example: a 
disk drive is a random access, file structured, read/write device; a printer is a 
sequential, record oriented, write only device; a tape is a sequential, record 
oriented, read/write device; a console is a sequential, character oriented, 
read/write, 'softcopy* (CRT) device with cursor addressing abilities; etc. 

Logical devices may be detached by using the ATTACH command with no physical device 
specified. Logical devices may be re-attached to another device without first 
detaching the device. Physical devices may be attached to more than one logical 
device name at any one time (except for disks). 



Logical Device Naves 



Name 



Synonym Restrictions-Definition 



Options 



CON IN 

CONOUT 

CONSOLE 

S 

A thru G 

PRINTER 1 

PRINTER2 

PRINTER3 

PRINTERS 

READER 

PUNCH 

C0MM1 

C0MM2 

C0MM3 

C0MM4 

TAPE1 

TAPE2 

TAPE3 

TAPE4 



PRT 

PRT2 

PRT3 

PRT4 

RDR 

PCH 

COM 

COM2 

COM3 

com 

TAP 
TAP2 
TAP3 
TAP4 



Console input (keyboard) 
Console output (screen, etc) 
Combines both CONIN & CONOUT 
System disk 
Disks 



Character oriented, input device 

Character oriented, output device 

Communications 

Communications 

Communications 

Communications 

Record oriented device 

Record oriented device 

Record oriented device 

Record oriented device 



P,L,C 
PLC 

h!s$t,sts,r 
h,stp,sts,r, public 

P,L,0,ALF,PP 
P,L,0,ALF,PP 
P,L,0,ALF,PP 
P,L,0,ALF,PP 
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Physical Device Haaes 



Name* Synonym* Restrictions-Definition 



Options 



CRT VDM Video Display Monitor 
KEY KB Keyboard 

5101 SIO Serial I/O port 

5102 thru SI08 Serial I/O ports 
PI01 LP or PIO Parallel I/O port 
PI02 thru PI08 Parallel I/O ports 
DISK1 thru DISK8 Disk drives 

nn Physical device driver numbers 



B,LF,FF,PO,PE,ENAB,SDLC,SYN<V 
B^FFsPOjPEjENABjSDLC^SYNCV 



n , STP , STS , K, PUBLIC 
Any that may apply. 



Refer to 



* Specific names and synonyms are determined by the SYSTEM »DEVN AMES file, 
the appendix on system files for a description of this file. 

The system disk (S) may be re-attached to the same or a different disk driven When 
the attachement is to the same drive the attach program will request that you mount 
the new system disk on that drive. When this has been done the system will find 
the location of the various programs on the new system disk. The new system disk 
must have all required system files and a NUCLEUS of the same version as the old 
system disk. 

When the attachment is to a different drive the ATTACH program will not ask you to 
indicate when the disk is mounted. 

When the serial port is attached the number of stop bits generated for each byte 
transmitted is dependent upon the baud specified: a baud of 110 causes two (2) 
stops bits; a baud greater than 110 causes one (1) stop bit. This is generally 
consistent within the data processing industry. 

When a physical device is attached for the first time the device driver program (a 
SYSTEM file) is loaded into~ high memory, removing that memory from general use. 
Detaching a device will unload the device driver (thus freeing up memory) if, and 
only if. the device is not attached to another logical name and the device driver 
is the last driver loaded in memory (driver at top of stack). 

When a physical device is detached with the ATTACH command and that driver is 



currently" at the top of memory (no devices following it) 
unloaded and the memory space made available for future use. 
not at the top of memory the driver is unloaded by the 



available. For this reason, 
that they were attached in. 



the driver will be 
When the driver is 
memory is not made 



users should detach devices in the reverse sequence 



The ATTACH command cannot be used 
first time (except disk drives). 



from BASIC or EDIT to attach a device for the 



The ATTACH command allows you to attach disk drives out of sequence. This means 
that you may have drives S. D, and G attached without having drives A, B, C, E, and 
F attached. In addition the drives may be detached with no regard for other disk 
attachments. 



All device attachments are SYSGENable. 
made and SYSGENed: 



If the following disk attachments have been 



S DISK1 
A DISK2 
D DISK4 
G DISK3 

and the system is re-booted with the system disk in a drive other than DISK1, the 
system will automatically detach all drives equal to the system disk. For example, 
if the above system were re-booted with the system disk in drive 3 the attachments 
would be : 

S DISK3 
A DISK2 
D DISK4 

When a device is attached in the multi-user OASIS it is a private device, i.e.o 
only the user attaching the device may access it. An exception to this is a dislc 
device which may have an option of PUBLIC specified. 



ATTACH 
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ATTACH Options 

The ATTACH command allows various options to be specified when certain devices are 
attached. These options are available depending upon the physical or logical 
device being attached. The previous tables listed the options available for each 
logical or physical device. 

All of the following options may have defaults set in the SYSTEM. DEVN AMES file. 
Refer to the appendix on system files for a description of this file. 



ALF 



£nnnn 



£n 



FFnnn 



Hnnn 



Lnnn 



This option specifies that the listing device has " an automatic line feed 
upon carriage return. When this option is not specified OASIS will append 
a line feed character to a carriage return character on output (unless 
ANSI forms control is specified and the no line advance control is used) . 
Most listing devices can optionally set the Auto Line Feed off. 

Indicates the BAUD (bits per second) of the serial device being attached. 
When this option is not specified for a serial device the default BAUD of 
9600 is used. The available BAUDs that may be specified include: 110. 
300, 600, 1200, 2400, 4800, 9600, 19200, 38400. 

Note: Not all systems support programmable baud rate generators. 

Indicates the class of terminal or printer » Many terminals have special 
codes to control the cursor or forms. The class code number specifies 
which SYSTEM. CLASSnn file to use for translation of the codes used by the 
specific terminal. 



a terminal as a console and it is not one of the 
implemented then refer to the appendix on "Terminal 



If you need to use 

terminals currently implemented then refer to the appendix on "Terminal 

Class Codes" and the OASIS MACRO Assembly Language Reference Manual for 

details on how to wrTTe your own SYSTEM. CLASSnn file to control your 

terminal. 



The class codes currently available for terminals are listed in the 
appendix "Terminal Class Codes" at the back of this manual. Due to the 
time lag between implementing new class codes, documenting them and 

fetting the documentation printed there may be more class codes available 
han are actually listed in that appendix. 

J§NAB[n] Indicates that transmission on the serial port is to use a specific 
handshake protocall in the output direction only. There are four 
protocalls known to OASIS serial drivers: 

ENAB1 Monitor the DTR line (data terminal ready). When this line has 
a true status a character will be output to the device. This is 
the most efficient handshake protocall used by OASIS. 

ENAB2 Transmision of a DC3 character from the device indicates that 
it is not ready to receive characters: transmission of a DC1 
character from the device indicates that it is ready to receive 
characters. 

ENAB3 Each line of data sent to the device is terminated with an ETX 
character. Transmission of another line of data is not begun 
until an ACK character is received from the device. 

ENAB4 Monitor the CTS line (clear to send). When this line has a 
true status a character will be output to the device. 



Note: Enable 
system. 



options 1 and/or 4 may not be supported by your 



Indicates the number of milliseconds (one thousandths of one second) 
required by the device to execute a form feed. The range of this value 
may be between and 63999 (up to 64 seconds). The default value is zero. 
This option may be specified in addition to the ENABLE option — both will 
be in effect. 

Indicates the number of milliseconds required for disk head load time. 
This option is used to fine tune the disk driver to your specific set of 
disks. 

Indicates the line length for the listing device or console being 
attached. When this option is not specified the default value for the 
specific device is used. Normally the default for printers is 80; the 
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default value for consoles terminals is 79 • 

ULnnn Indicates the number of milliseconds that the system is to pause after 
outputting a carriage return or line feed character to the device. The 
range of this value may be between and 63999 (up to 64 seconds J. The 
default value is zero* This option may be specified in addition to the 
ENABLE option — both will be in effect. 



£nn 



£nnn 



PE 
IE 



ftJBLIC 

£nn 

SDLC 

STP_nnn 

STSn nn 

SYNC 

m 

WAIT 



Indicates the overflow size of a listing device. The overflow size is the 
number of lines between the last print line of a page and the first print 
line of the next page. The specification of this option implies that the 
listing device does not have a form feed capability. Most listing devices 
do have form feed capabilities. The default for this option is zero, 
implying that the device does have form feed capability. 

Indicates the page size of the device being attached. This value is used 
when the system is outputting data to the device. The value indicates the 
number of lines of data that are to be transmitted before a page eject 
command is given. When this option is not specified the default value for 
the specific device is used. Normally the default is 56 for printers and 
23 for console terminals. 



This option and the L 
performing the output. 



option have no effect when a user program is 



Indicates that the serial device requires even parity communication. 

When PO or PE is not specified then no parity is used. 

Indicates that the serial device requires odd parity communication. 

This option specifies that you wish page parity to be maintained on the 
listing device. Page parity means that a report or listing to the device 
is to contain an even number of pages (an extra form feed is performed, if 
necessary) . This option is useful in causing reports to start on an 
"infold". When page parity is in effect the listing device is assumed to 
be at the correct page when a file is opened to it. 

Indicates that the disk is to be attached with public access, i.e., all 
users may utilize the disk. When this option is not specified the disk 
may only be used by the user attaching it. This option may only be used 
when in single user mode. 

Indicates the number of disk errors that may occur consecutively before a 
message is displayed on the console. 

Indicates that, if the device driver is capable of it, the SDLC protocall 
is to be used for transmission of data. 

Indicates the number of milliseconds required for track- to- track disk head 
step time. This option is used for fine tuning the disk driver to your 
specific set of disks. 

Indicates the number of milliseconds required for disk head settle time. 
This option is used for fine tuning the disk driver to your specific set 
of disks. 

Indicates that, if the device driver is capable of it. the device is to be 
initialized with syncronous protocall. When this option is not specified 
asyncronous protocall is used. 

Indicates that, if the device driver is capable of it, eight bit bytes are 
to be transmitted. When this option is not specified seven bit bytes our 
output. 

Indicates that if the physical device desired is in use by another 
partition the ATTACH command is to inform you of the situation but is to 
wait for the device to become available (other user must detach it). When 
this option is not specified and the device requested is attached to 
another partition the ATTACH command will exit without performing your 
attachment . 



13*1 Pfysical Device Synonyms 

Physical device names, synonyms, and general attributes are contained in the system 
file SYSTEM. DEVNAMES:S. The OASIS system is distributed with the standard device 
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names listed in the table above. You may change, delete or add device names and 
synonyms by editing this file. 

Refer to the Appendix on "System Files" for details about this file. 

13*2 Optimizing Disk Access 

Performance of your system may be significantly improved by using the proper step 
time, step settle time and head load time. The system, as distributed, is set for 
the times recommended by the disk drive manufacturer. Although this does insure 
that the disk access will be reliable it might not give optimal performance. 

If you wish to try to get more performance out of your system you are advised to 
try using lower STP and STS values. A suggested method of doing this is to lower 
the values a little bit. perform a SEEK test; (or any other operation that moves the 
disk heads around a lot) . If no errors are reported then lower the values a little 
more and retest it. If any errors are reported then raise the value back up to the 
last value that didn»t report any errors. 

When you have found the values that give you fast and reliable disk access use the 
SYSGEN command to save that setting. 

Note: Each drive may require different values. Test each drive separately and 
SYSGEN the proper values after they are determined. 

ATTACH Examples 

>ATTACH READER SI01 

>ATTACH PRINTER PIO (L66,PP 

>ATTACH A DISK3 

>ATTACH 

Options 

"SYSTEM^ ", avails 1 0K, dirsize=80 , STS6 , Public 

»* Not Mounted ** 

"DATA1 ",avail=247K,dirsize=l6,STS8,WP 



Name 


Device 


S 


DISK1 


A 


DISK3 


B 


DISK2 


CONIN 


KEYBOARD 


CONOUT 


CRT 


PRINTER1 


LP 



L79 , P23 , C7 ,LF0 , FF6 ,B9600 
L80,P56,LF25,FF50 



The above example illustrates the use of the ATTACH command to show the current 
attachments. For attached disks additional information is given about each disk, 
under the options column. The first field in this column is the label of the disk, 
next is the available capacity of the disk, the capacity of the directory, and 
whether the disk is write protected. 

Note: The phrase "Not mounted" may appear. This has no relationship to whether or 
not a disk is mounted in the drive. It only means that the system has not accessed 
the disk since the last mount was performed and therefore does not know the label 
information, etc. The disk is attached ! 
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The BACKUP command allows you to copy the entire contents of a disk to another disk 
or tape. This is usually done on a periodic basis for protection or archive 
purposes. The format of the BACKUP command is; 

M.QKUP [<fd1> <fd2>] C(NQEEMFI[)]] 

Where; v 

fd1 Indicates the directory label of the source disk or tape. 

fd2 Indicates the directory label of the destination disk or tape. 

NOVERIFY Indicates that the information written on the destination disk is not to 
be verified (no read after write) „ This option applies only when the 
destination is a disk drive. 

If you omit fd1 and fd2 then OASIS will perform the backup from the disk drive 
attached as , S» to the disk drive attached as 'A*. 

When the BACKUP program is entered the source and destination directory labels are 
displayed for confirmation. If the displayed directory labels are correct enter a 
carriage return to indicate that you have loaded your disks and are ready to 
continue. If the drive labels are incorrect then enter an f N», carriage return. 
The program will then ask you to enter the correct source and destination drive 
codes . 

The BACKUP program next informs you of the labels of your source and destination 
disks or tape and waits for confirmation. If the labels are correct carriage 
return and the backup process will proceed. If the labels are incorrect enter an 
f N», carriage return, and the program will redisplay the drive labels. 

After the disks have been copied the BACKUP program asks if you wish to backup 
another set of disks. If you do then enter a *Y», carriage return and the cycle is 
repeated. If you do not wish to copy another disk then enter a carriage return. 

BACKUP performs an automatic MOUNT of the source and destination drives before and 
after a disk copy. 

Note; If, after the backup operation is complete, a SHOW DISK of the destination 
reports a +8 mis-allocation, then the backup operation did not go to completion. 
Retry the BACKUP procedure, making sure that it goes to completion. 



wnen tne nuvekim option is not speciriea the Dacicup program will veriry tne copy 
being made by performing a read after write operation and comparing the read-back 
data with the data originally read in from the source drive. When an error is 
detected the following message will be displayed on the console; 

Compare Error, Sector nn, Byte nnH, sb: nnH, is; nnH, retry (Y/N)? 

where sector is the relative sector number of the source drive, byte is the 
relative byte number of the sector, sb is the should be contents, is is the actual 
contents read back. Any response other than a Y will cause the backup process to 
be aborted. A Y response will cause the sector to be re-written and verified. 

S The BACKUP command may only be used to copy a privately attached disk to another ! 
privately attached disk or to copy from or to a public disk while in single user 



mode. 

The following example illustrates the display of the BACKUP command. 
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>BACKUP 

Source on drive S( 1 ) 
Destination on drive A(2) 
Mount disk now (Y/N) - N 

Enter new source drive code - A 
Enter new destination drive code - B 

Source disk is labeled "DISK1234 11 
Destination disk is labeled "DISK4321 " 
OK to start copy (Y/N) - Y 

End of copy, again (Y/N)? - Y 

Source on drive A(2) 
Destination on drive B(3) 
Mount disks now (Y/N) - Y 

Source disk is labeled "LABEL1 " 
Destination disk is labeled "LABEL2 " 
OK to start copy (Y/N) - Y 

End of copy, again (Y/N) - N 

> 
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The CHANGE program provides a means of changing the privilege value of OASIS system 
programs. The format of the command is: 

J2JUGE <file-dese> (PHI? <nnn>[)] 

Where: 

nnn Indicates the value that the programs privilege value is to be set to. 
The range of values that a privilege value may be set to include to 5° 

Note that this command requires the option PRIV to be used, unlike other commands 
where options are optional. 

The file-desc must be of an absolute or relocatable program file. 

When this command is executed the privilege value of the program specified by 
file-desc is changed to the value indicated. Afterwards that program may only be 
executed if the current system privilege level is equal to or greater than the 
privilege value of the program. 

You may not change the privilege value of a program if the current privilege value 
of that program is greater than your current privilege level. 

Refer to the appendix on Privilege Levels for further information. 

Example: 

>CHANGE TEXTEDIT. COMMANDS (PRIV 2 
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The COPYFILE command allows you to copy one file to another, copy groups of files, 
copy a file or group of files from one disk to another, or copy selected records of 
one file to another. The format of the COYPFILE command is: 

£OFIFILE <file-desd> [<file-desc2>] [(<options>[)]] 

or 

£OFIFILE <dev1> <file-desc2> [«options>[)]] 

or 

£OPIFILE <file-desd> <dev2> [(<options>[)]] 

or 

£OPYFILE <dev1> <dev2> C«options>[)]] 

Where : 

<file-desc1> Indicates the file description of the source file. Wildcards are 
acceptable. The file disk must be specified explicitly or with an 
asterisk as the syntax of this command is position dependent. All files 
that you have access to (private, public, and shared) may be source files. 

<file-desc2> Indicates the file description of the destination file. An equal sign 
is acceptable for each element, indicating that the source file's 
description is to be used. Destination files are always private files. 
If the source file is a shared file then the destination file description 
must be different than the source or an error will occur. (A shared file 
has a directory entry in your account name. The copy process detects the 
existing file entry but cannot erase it as it is not trully yours.) 

<dev1> Indicates the logical device name of the source file. The device may be 
any character oriented device with the exception of a tape supported by an 
OASIS supplied tape driver. 

<dev2> Indicates the logical device name of the destination file. The device may 
be any character oriented device with the exception of a tape supported by 
an OASIS supplied tape driver. 



Optionally you may specify only one file description. This 
COPYFILE command as indicating an in-place file translation. 

COPYFILE Options 

Options for the COPYFILE command are as follows: 



is interpreted by the 



MOUNT 



NEWDATE 



NEWFILE 



JIQgUERY 



NQTYPE 



Indicates disks must be changed before the copy can be performed. When 
this option is specified COPYFILE will pause before beginning the copy, 
display the message "Change disks now" and wait for the operator to type a 
carriage return before performing the copy. 



Indicates that the destination file(s) is to use 
for its directory entry. 



the current system date 



Indicates that destination files are not to replace any pre-existing 
files. If a destination file specification is identical to an existing 
file specification then the copy is not performed. This is a default 
option. 

Indicates that COPYFILE is to copy each file that matches the 
specifications without asking the operator for permission. This is a 
default option when the source file description is explicit. When this 
option is not used and the input file description is not explicit (uses 
wildcards) the COPYFILE program will display each file description that 
matches the specification and ask (query) the operator if the file is to 
be copied. 

Indicates that the results of each file copy are not to be displayed on 
the system terminal. When this option is not specified the source and 
destination file descriptions are displayed on the console along with the 
copy type ("copied to", "replaces", "appended to", etc.). 
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NQIERIFY Indicates that COPYFILE is not to verify its copy. This is a default 
option. 

OLDDA TE Indicates that the destination file(s) is to use the date from the 
directory entry of the source file for its directory entry. This is a 
default option. 

PUBLIC Indicates that COPYFILE is to allow public files to be included in the 
source files. 

fiUERY Indicates that COPYFILE is to ask you on a file-by-file basis, if the file 
is to be copied. A reply of Y is required for the file to be copied. 
This is a default option if the source file description includes 
wildcards. 

fySPLACE Indicates that the destination file may replace a pre-existing file of the 
same specification. This is a default option only when an m-place file 
copy is specified. Note: DELETE protected files may not be replaced (see 
the RENAME command). 

UPE Indicates that the results of each file copy is to be displayed on the 
console. This is a default option. 

XERIFY Indicates that COPYFILE is to verify its copy by performing a read after 
write. 



The following options may be used only when the source 
sequential in format (not direct or indexed). 



and destination files are 



AP£END Indicates that the output is to be appended to a pre-existing file of the 
same specification. If no file exists with the same specification then 
one is created. Note: WRITE protected files may not be appended to (see 
the RENAME command). 

FOR nnnn indicates the number of records that are to be copied including the first 
record qualifying. 



FROM nnn Indicates the first record to be copied from the source file, 
decimal record number and must follow the option FROM. 



nnn is the 



FRLABEL xxxxxxxx Indicates the first record to be copied from the source file. 
xxxxxxxx is a character string which appears at the beginning of the first 
input record to be copied. This string may be up to eight characters in 
length and may not include imbedded blanks. If the source file does not 
contain a record that starts with this character string then no records 
will be copied. 



JaQHCASE Indicates that all uppercase characters in the input records are 
translated into their lower case equivalents before being copied. 



to be 



NOTRU NC Indicates that trailing blanks from each input record are 
removed before the record is copied. This is a default option. 



not to be 



PACK Indicates that repetitive characters in the source file are to be coded 
and packed before copying. All consecutive occurrences of two or more 
blanks in the input records are encoded as a two character sequence. All 
consecutive occurrences of four or more other characters are encoded as a 
three character sequence. 

TOLA BEL xxxxxxxx Indicates the last record to be copied from the source file. 
xxxxxxxx is a character string which appears at the beginning of a record. 
The record containing this string is not copied but indicates that no more 
records from this source file are to be copied. This string may be up to 
eight characters in length and may not include imbedded blanks. If the 
source file does not contain a record starting with this string after the 
first qualifying record then the remainder of the file is copied. 

TRANS Indicates that a character translation is to be performed on the source 
file as it is copied. When this option is specified COPYFILE will display 
the message "Enter Translation List" on the console terminal and accept 
input from the operator. The prompting character in this mode is the 
right parenthesis » ) ' . 



COPYFILE 



- 42 - 



SYSTSf Rer B 



CHAPTER 16: COPYFILE COMMAND 

The translation list consists of pairs of characters entered from the 
console, separated by one or more blanks. Each character may be specified 
by typing the character itself or by typing its numeric equivalent. 

The translation list may be continued onto additional lines by typing *++* 
as the last two characters of the line. This indicates that the 
translation list is continued on the next line. All characters after '++' 
on the line are ignored — you may enter a comment after the ++. A line may 
not be continued in the middle of a character pair. 

TRUNC Indicates that trailing blanks from each input record are to be removed 
before the record is copied. 

UNPACK Indicates that encoded repetitive characters are to be expanded into the 
normal format. 

When neither PACK nor UNPACK is specified the copy will be performed 
without any compression or expansion of repetitive characters. 

UPCASE Indicates that all lower case characters in the input records are to be 
translated into their upper case equivalents before being copied. 

Note 1: When file-desd is a file that has READ protection (see RENAME command), 
the file must be copied in its entirety. This means that the following options are 
not valid when a READ protected file is being copied: FROM, FRLABEL, FOR, TOLABEL, 
TRUNC, PACK, UNPACK, LOWCASE, UPCASE, APPEND, and TRANS. 

Note 2: When a file is copied in its entirety the destination file will have the 
same protection status as the source file. When a file is not copied in its 
entirety (any of the options listed in Note 1) the destination file will have no 
protection status set (except option APPEND which will not affect the protection 
status of the file being appended to). 

COPYFILE Examples 

>COPYFILE DAVID. LETTER :S = = A 

DAVID. LETTER :S copied to DAVID. LETTER: A 

>COPYFILE «. BASICS = = A 
PR0G1.BASIC:S Okay to copy (Y/N)? N 
PR0G2. BASIC :S Okay to copy (Y/N)? Y 
PR0G2. BASIC'S copied to PR0G2.BASICA 
PR0GRAM3. BASIC :S Okay to copy (Y/N)? N 

>COPYFILE PR0G1. BASIC'S PR0G2 . BASIC : S (APPEND 
PR0G1. BASIC :S appended to PR0G2 . BASIC : S 

XJOFYFILE PR0GRAM3.BASIC:S PR0G2 . BASIC : S 
PROGRAMS. BASICS not copied to PR0G2. BASIC'S 
- because file exists 

>COPY PR0GRAM3. BASIC'S PR0G2.=:S (REPLACE NOTYPE 

>COPY FILE1.TEXT:S NEWFILE1.=:A (FRL THE FOR 99 APPEND 
FILE1.TEXT:S appended to NEWFILE1 .TEXT:A 

>C EXAMPLE. FILE: S = = A (TRANS 
Enter Translation List: 

\ ++ TRANSLATE UP-ARROW TO BACKSLANT 

. , ++ TRANSLATE PERIOD TO COMMA 

5FH 2EH ++ TRANSLATE UNDERSCORE TO PERIOD 

>COPYFILE C0MM1 PRINTER1 (TRUNC 
>COPYFILE C0MM4 DATA.FILE:A 
> 
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The CREATE command allows you to create new indexed, keyed, or direct files. It is 
the only means of doing so. The CREATE command cannot be used to create a 
sequential format file — you must use the TEXTEDIT, EDIT, COPYFILE programs Or 
write a program to do the sequential file creation. The format of the CREATE 
command is: 

£^ATE <file~dese> «option>...[)l 

Where: 

file-desc Indicates the file description of the file to be created. Wildcards are 
not allowed, and the file disk must be specified. 

CREATE Options 

£LEAR Indicates that the indexed, keyed or direct file (one must be specified) 

already exists and that the current file is to be cleared— set to binary 

zeros. The existing file's filesize, record length and keylength will be 
used. 

HIRECT Indicates that the file is to be created as a direct access file. 

FILESIZE nn Indicates that the decimal number nn is the number of records the file 
is to contain. The maximum number of records per file is 65535 • 

If the file is a direct file then this number is the actual filesize. If 
the file is an indexed or keyed file then the CREATE program will create a 
file with at least this many records. The actual filesize will be 
determined by an algorithm required by the system's access method. See 
the appendix "Indexed and Direct Files". 

XNDEXED Indicates that the file is to be created as an indexed access file. 

KEYED Indicates that the file is to be created as a keyed access file. 

KEYLE N nn Indicates that the decimal number nn is the length of the index key. 
KEYLEN may only be specified for INDEXED or KEYED files. The maximum 
length of a key is 128. 

SECLEN nn Indicates that the decimal number nn is the physical length of each 
record in the file. The maximum length of a record in the system is 512. 

This length is exclusive of any key length specified., 

The CREATE command requires contiguous available space on the disk to create a 
file. If the largest contiguous available space is not large enough to hold the 
file being created the message "Disk full" is displayed. 

The CREATE command sometimes appears slow to execute. This is due to the fact that 
CREATE not only creates the file but also initializes the entire file space to be 
null or empty records. 

The number of blocks allocated to the file by the CREATE command is dependent upon 
the FILESIZE, RECLEN, and KEYLEN options. 

When the file is a direct file then the allocation will be: 

Allocation = (RECLEN * FILESIZE) / 1024 , rounded up. 

When the file is an indexed file then the allocation will be: 

Allocation = 

2 * FILESIZE / 1024 , rounded up 

+ 

(2 + RECLEN + KEYLEN) * FILESIZE / 1024 , rounded up 

When the file is a keyed file then the allocation will be: 

Allocation r (RECLEN + KEYLEN) * FILESIZE / 1024 , rounded up 
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To compute the FILESIZE for a restricted allocation area the following formula 
should help: 

(avail) * 1024 
FILESIZE = 

RECLEN + KEYLEN + 4 

CREATE Examples: 

>CREATE CUSTOMER. MASTER: A (INDEXED FILE 2000 REG 64 KEY 30 

>CREATE TRANSACT. DETAIL: ACCOUNTS (DIRECT FILE 9760 REC 32) 

>CR SAMPLE. DATA :D (CLEAR 

The first example will create an indexed file on drive A with space for 2003 
records; length of key is 30 characters; length of record is 64. The number of 
disk blocks required for this file will be 192. 

The second example will create a direct file on the disk labeled ACCOUNTS with 
space for 9760 records of length 32. The number of disk blocks required for this 
file will be 305. 
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The ERASE command allows you to remove your own private files from the system. The 
format of the ERASE command is: 

ERASE <file-dese> [(<option>...[)]] 

Where : 

file-desc Indicates the file description of the file or files to be erased. 
Wildcards are acceptable. 

ERASE Options 

TYPE Indicates that the file description of each file erased is to be displayed 
on the console. This is a default option. 

NOTYPE Indicates that the file description of each file erased is not to be 
displayed. 

.QUERY Indicates that the operator will be asked (queried) on a file by file 
basis if the file is to be erased. This is the default option when the 
file description is not explicit. 

NOQ UERY Indicates that the operator is not to be asked on a file by file basis if 
the file is to be erased. This is a default option when the file 
specification is explicit. If this option is not specified and the file 
description is not explicit (wildcards used) the file description of each 
file that matches the specification is displayed on the console and the 
operator is asked (queried) if the file is to be erased.. Only a response 
of Y will cause the rile to be erased. 

The system will not allow this command to erase a file that has DELETE protect 
status. If a file has DELETE protect status you must first use the RENAME command 
to change the protect status. 

Care should be taken if the file is shared by another account. If the file is to 
be erased and not re-added in the near future the operator* should first use the 
SHARE command to verify if any other users have shared access to the file. If 
another account does have shared access the SHARE command should be used to remove 
this access before the file is erased. Having shared access to a deleted file may 
cause problems in the other account. 



Examples 



>ERASE F*.*:A 

FILE1.BASIC:A Okay to Erase (Y/N)? N 
FILELIST. COMMAND: A Okay to Erase (Y/N)? Y 
FILELIST. COMMAND: A Protected 

>ERASE X*.*:A 
No files erased 

>ERASE F*.*:A (NOT 

FILE1.BASIC:A Okay to Erase (Y/N)? Y 
FILELIST. COMMAND:! Okay to Erase (Y/N)? Y 
FILELIST. COMMAND: A Protected 

> 
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The FILELIST command allows you to display the directory entries for files in your 
account. The format of the FILELIST command is: 



£ILELIST [<file-desc>!<fd>] [(<option>...[)]] 



Where : 



<file-desc> Indicates the file or files to be included in the directory search and 
list. Only files in your account will be included. To include files in 
the public account you must use the asterisk option. Wildcards are 
acceptable. 

<fd> Indicates the directory label or disk label of the disk to be searched. 
When fd is omitted all of the ATTACHed directories will be searched. An 
fd without a file name or file type indicates that all of the files on the 
specified directory are to be listed. Only files in your account will be 
included, unless the asterisk option is used and then only files in your 
account and the public account will be included. 

<blank> When the file-desc or fd is not specified all directories, all file names, 
and all file types are included in the listing. 

Directory Fields 

The directory contains all the information necessary for the system to maintain the 
files. This information is contained in a directory entry for each file. Most of 
the information is displayable by the FILELIST command. This information includes 
the following columns in the order listed here. 



Fnaae 
Ftype 
Dit 
Date 

Time 

Recs 

Blks 
Fonat 



This is the file name as defined earlier. 

This is the file type as defined earlier. 

This is the directory label as assigned by the ATTACH command. 

This field is updated with the current system date whenever the file is 
changed, created, or appended to by a user program or by one of the OASIS 
commands . 

Similar to the date field. 

Note: Your system may not support the time of day feature. 

This field indicates the current number of records in the file. For 
direct files it is the total file allocation as specified at creation 
time. 

This field indicates the number of 1024 byte blocks in use by the file. 

This column contains two parts: 

A character specifying the physical format of the records in the file. 
The character indicates its format is: 

S Sequential 

I Indexed access 

K Keyed access 

D Direct access 

R Relocatable command 

A Absolute command 

This character is followed by any protection status set for the file: 

D Delete protected 
W Write protected 
R Read protected 

The second part indicates the length of the records in the file. For 
sequential files it is the length of the longest record in the file as the 
file may contain records of variable length. For direct and indexed files 
it is the length as specified at creation time. 

Label This is the disk label as assigned by the INITDISK command. 
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Sect This field is the starting sector number of the file and is only displayed 
when the asterisk option is specified. 

Other This field is only displayed when the asterisk option is specified and 
contains two columns? the first column is a numeric value and the second 
column is a letter code indicating what the first column is. The letter 
codes are as follows : 



E 
L 

F 

FILELIST Options 



- Indicates that the preceding number is the ending sector number 
of the file (only for sequential files). 

- Indicates that the preceding number is the length of the 
program file (only for relocatable program files). 

- Indicates that the preceding number is the origin address of 
the program file (only for absolute program files). 

- Indicates that the number is the allocated filesize of the file 
(only for indexed data files). 



FNAME Indicates that the list is to include only the file name column. 

FTYPE Indicates that the list is to include the first two columns: Fname, and 
Ftype. 

FDISK Indicates that the list is to include the first three columns: Fname, 
Ftype, and Drv. 

DATE Indicates that the list is to include the columns: Fname, Ftype, Drv, 
Date, and Time. 

Note: Your system may not support the time of day feature. 

ALLOC Indicates that the list is to include the columns: Fname, Ftype, Drv, 
Date, Time, Recs, and Blks. 

FORMAT Indicates that the list is to include the columns: Fname, Ftype, Drv, 
Date, Time, Recs, Blks, and Format. 

LABEL Indicates that the list is to include the columns: Fname, Ftype, Drv, 
Date, Time, Recs, Blks, Format, and Label. 

When none of the above seven options is specified the FILELIST command 
will display as many columns as can fit in a line on the device. This is 
determined by the attached line length. 

*. (Asterisk) Indicates that the listing is to include all information 
contained in the directory for both the public files and the files owned 
or shared by this account. Unless this option is specified only the files 
owned or shared by this account will be included in the listing. 

This option must be used if you wish to have the Sect and Other columns 
displayed. 

TYPE Indicates that the listing is to be displayed on the system console. This 
is a default option. 

PRINTER [n] Indicates that the listing is to be displayed on the printer. If n is 
not specified then 'PRINTER 1 is used. 

EXEC Indicates that the listing is to be written to disk and given the name 
» SELECTED. EXEC :S T . This option may not be used with the option OWNER. 
When EXEC is specified the default for fields included is FDISK. The 
records created in this file contain 9 variables for use when the file is 
executed by the EXECutive procedure processor. This option and the change 
in default allows you to create a file of file descriptions to be used by 
the EXEC command as explained in the manual describing the EXEC language. 
The file created by this option can also be used by a user written 
program, of course. 

FILE Indicates that the listing is to be output to the system disk and given 
the name: SELECTED.FILES:S. This option may not be used with the option 
OWNER. This option is very useful for creating a data file of file names 
to be used by an application program. Similar to the EXEC option, the 
records created contain the filename, filetype, and filedisk unless 
another option specifies more or less information to be included. 
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APPEND Indicates that the listing is to be APPENDED to a previously created file 
named SELECTED . EXEC : S or SELECTED. FILES :S. This option is used in 
conjunction with the EXEC or FILE option. 

HEADER Indicates that the listing is to include a heading at the top of each 
page. This is the default except when the EXEC option is specified or 
when less than the date column is listed. 

NOHE ADER Indicates that the listing is not to include a heading at the top of each 
page. This is the default when the EXEC option is specified or when less 
than the date column is listed. 

NOSO RT Indicates that the list is to be in the same sequence as in the directory. 
This option may not be used with the OWNER option. 

SORT Indicates that the list is to be sorted by file name, file type, and file 
directory label. This is a default option. 

mm/dd/yy Indicates that only files whose update date is greater than or equal to 
this specified date are to be included. The date must be in normalized 
format: mm/dd/yy. 

OWNE R Indicates that all files that qualify to the file specifications are to be 
included, independant of the file's owning account. This option may only 
be used if your privilege level is five or you are currently logged onto 
the system account. 

The output produced when this option is used will group the files by 
account owner with a page break between each account. (This option can 
only be used when output is to the console (TYPE) or printer (PRINTn), not 
with options EXEC or FILE. ) The heading of each page of the listing will 
include the owning account name. Files owned by an account number that is 
not defined in the SYSTEM. ACCOUNT file will have a name of ????????. 

FILELIST Examples 

The following examples illustrate some of the options of the FILELIST command. The 
Date, Time, Recs, and Blks used in these examples do not necessarily reflect the 
current release of the operating system. 

Note: Your system may not support the time of day feature. 

>FILELIST * EXEC S (FD 
IPL EXEC S 
1 file(s), 1 block(s). 

>FILELIST S* * S (DATE) 

Fname> Ftype — Drv -Date — Time- 



SET 

SHOW 

SYSGEN 

SYSTEM 

SYSTEM 

SYSTEM 

SYSTEM 

SYSTEM 

SYSTEM 

SYSTEM 

SYSTEM 

SYSTEM 

12 file( 



COMMAND 

COMMAND 

COMMAND 

CSI 

DEV02 

DEV11 

DEV12 

DEV13 

DEV9 

EXECSAVE 

NUCLEUS 

UPDATES 



02/11/80 
02/12/80 
02/12/80 
02/11/80 
02/21/80 
02/21/80 
02/21/80 
02/21/80 
02/21/80 
02/22/80 
02/11/80 
02/12/80 



s), 41 block(s). 



22 
14 
22 
21 
13 
13 
13 
13 
13 
20 
15 
22 



55 
58 
49 
41 
12 
22 
25 
32 
07 
04 
57 
50 



>FILELIST D* * S (FNAME 

DUMPDISK 

1 file(s), 2 block(s). 
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>FILELIST S 




Fname 


Ftype — 


Drv 


ASSIGN 


COMMAND 


S 


ATTACH 


COMMAND 


S 


BACKUP 


COMMAND 


S 


BASIC 


COMMAND 


S 


COPYFILE 


COMMAND 


S 


CREATE 


COMMAND 


S 


DUMPDISK 


COMMAND 


S 


EDIT 


COMMAND 


S 


ERASE 


COMMAND 


S 


FILELIST 


COMMAND 


S 


INITDISK 


COMMAND 


S 


IPL 


EXEC 


S 


LIST 


COMMAND 


S 


LINK 


COMMAND 


S 


MEMTEST 


COMMAND 


S 


MOUNT 


COMMAND 


S 


PATCH 


COMMAND 


S 


RENAME 


COMMAND 


S 


RUN 


COMMAND 


S 


SET 


COMMAND 


S 


SHOW 


COMMAND 


S 


SYSGEN 


COMMAND 


S 


SYSTEM 


CSI 


S 


SYSTEM 


DEV02 


s 


SYSTEM 


DEV11 


s 


SYSTEM 


DEV12 


s 


SYSTEM 


DEVI 3 


s 


SYSTEM 


DEV9 


s 


SYSTEM 


EXECSAVE 


s 


SYSTEM 


NUCLEUS 


s 


SYSTEM 


UPDATES 


s 



Recs Blks Format- Label 



31 file(s), 132 block(s). 
>FILELIST S* * S (EXEC 
>LIST SELECTED EXEC S 



02/04/80 22 
02/05/80 20 
02/06/80 21 
02/12/80 22 
02/05/80 22 
02/04/80 12 
02/06/80 22 
02/02/80 10 
02/12/80 15 
02/29/80 22 
02/04/80 12 
02/24/80 23 
02/08/80 23 
02/08/80 19 
02/11/80 20 
02/04/80 15 
02/30/80 14 
02/12/80 16 
02/18/80 22 
02/11/80 14 
02/12/80 22 
02/12/80 21 
02/11/80 
02/21/80 
02/21/80 
02/21/80 
02/21/80 
02/21/80 20 
02/22/80 15 
02/11/80 22 
02/12/80 



13 
13 
13 
13 
13 



15 



33 
53 

II 
:04 

:.32 

:34 
:11 
:16 
25 
25 
50 
03 

53 
48 

05 
43 
55 
58 
49 
41 
12 
22 
25 
32 

k 

57 

3 



5 
13 

7? 

20 
6 



2 

15 

10 

4 

2 



68 
6 

13 
2 

22 
2 
4 
1 



8 

55 

133 



RDW 256 
RDW 256 
RDW 256 



19 RDW 256 



RDW 256 
RDW 256 
_ RDW 256 
14 RDW 256 
2 RDW 256 
RDW 256 
ADW 256 
S 12 
RDW 256 
RDW 256 
RDW 256 
RDW 256 
RDW 256 
RDW 256 
RDW 256 
RDW 256 
RDW 256 
RDW 256 
ADW 256 
RDW 256 
RDW 256 
RDW 256 
RDW 256 
RDW 256 
DD 



4 

2 

1 

4 

3 

1 

1 

3 

2 
17 

2 

4 

1 

6 

1 

1 

1 

1 

2 

4 
14 AD 

4 S 



512 
256 
44 



SYSTEM$C 
SYSTEM! IC 
SYSTEM! IC 
SYSTEM! >C 
SYSTEM! 5C 
SYSTEM! IC 
SYSTEM! iC 
SYSTEM! \C 
SYSTEM! ;C 
SYSTEM! iC 
SYSTEM! 5C 
SYSTEM! IC 
SYSTEM! IC 
SYSTEM! »C 
SYSTEM! >C 
SYSTEM! \C 
SYSTEM! ;C 
SYSTEM! JC 
SYSTEM! iC 
SYSTEM! JC 
SYSTEM!>C 
SYSTEMIC 
SYSTEMIC 
SYSTEM! ;C 
SYSTEM! >C 
SYSTEM! ;C 
SYSTEMIC 
SYSTEM! JC 
SYSTEM! iC 
SYSTEM! IC 
SYSTEM! iC 



SELECTED. EXEC :S 



&1 SET 

&1 SHOW 

&1 SYSGEN 

&1 SYSTEM 

&1 SYSTEM 

&1 SYSTEM 

&1 SYSTEM 

&1 SYSTEM 

&1 SYSTEM 

&1 SYSTEM 

&1 SYSTEM 

&1 SYSTEM 



COMMAND 

COMMAND 

COMMAND 

CSI 

DEV10 

DEV1 1 

DEV12 

DEV13 

DEV9 



EXECSAVE S 
NUCLEUS S 
UPDATES S 



&2 &3 
&2 &3 
&2 &3 
&2 &3 
&2 &3 
&2 &3 
&2 &3 
&2 &3 
&2 &3 
&2 &3 
&2 &3 
&2 &3 



&4 &5 &6 
&4 &5 &6 
&4 &5 &6 
&4 &5 &6 
&4 &5 &6 
&4 &5 &6 
&4 &5 &6 
&4 &5 &6 
&4 &5 &6 
&4 &5 &6 
&4 &5 &6 
&4 &5 &6 



&7 &8 &9 
&7 &8 &9 
&7 &8 &9 
&7 &8 &9 
&7 &8 &9 
&7 &8 &9 
&7 &8 &9 
&7 &8 &9 
&7 &8 &9 
&7 &8 &9 
&7 &8 &9 
&7 &8 &9 



>FILELIST ??S??? * S (FN 

ASSIGN 

BASIC 

LIST 

SYSGEN 

SYSTEM 

SYSTEM 

SYSTEM 

SYSTEM 

SYSTEM 

SYSTEM 

SYSTEM 

SYSTEM 

SYSTEM 

13 file(s), 28 block(s). 



FILELIST 
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FORCE COHHAHD 

! The FORCE command is only available on multi-user OASIS. 



The FORCE command provides a means of forcing another user to perform a task. The 
format of the command is: 



FORCE <pin> [<comiand>] 



Where : 



<pin> Indicates the partition identificatin number of the user or account to be 
forced. 

<command> Is the command that the user is to be forced to do. When the command is 
not specified the user will be forced to exit from the program he is 
doing. 

The FORCE command provides a useful, but dangerous, capability. Before using this 
command to force another user to perform some task you should use all other means 
to make sure that data or labor will not be lost. At the minimum, you should first 
send a message to the user asking him to perform the task voluntarily. If the user 
does not respond to this (away from console) then you should first check the status 
of his partition (SHOW MEMORY) to determine what he is doing and whether it would 
be okay to force him to perform your task. 

When the FORCE command is executed the user specified is forced to execute his quit 
error trap (system cancel-key) and, if a command was specified, execute the 
command. 

Normally, the FORCE command would only be used to LOGOFF users to get in a mode 
that would allow single-user operation. 

It is possible that the user may have a quit error trap set such that his program 
is not aborted (TEXTEDIT does this). In this situation the user will not be forced 
to perform the command until he returns to the CSI level. 
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IHITDISK COMfAHD 

The INITDISK command allows you to initialize a disk for use or re-use by the OASIS 
operating system. The format of the INITDISK command is; 



MTTDISK [<fd>] [«option>...[)]] 



Where : 
fd 



Indicates the disk drive containing the disk to 
is omitted A is assumed. 



be initialized. When fd 



IHITDISK Options 

Options for the INITDISK command include the following : 

BOOTs fd Indicates that the bootstrap loader is to be copied from the disk on drive 
fd instead of from the system disk. This option only operates in 
conjunction with the option FORMAT and can only be used on a system with 
three or more drives. 

BUILD Indicates that the disk is hard formatted and that you wish to only write 
a bootstrap sector, label sector, and directory to the disk. No other 
writing will be performed on the disk. 

CLEAR Indicates that you wish to initialize the directory space, erasing all 
existing files from that disk. This option is not valid wnen the system 
disk is initialized. 

FORMAT Indicates that you wish to initialize the format of the entire disk. The 
formatting process entails the writing of track and sector addresses and a 
data area consisting of a pattern of data. You may use this option on a 
disk that is write protected. This option is not valid when the system 
disk is initialized. 

HEAD Indicates the number of disk surfaces available on the disk. This option 
requires the option FORMAT and is followed by the number of surfaces. 

iNCR Indicates the logical sector increment value. This option requires the 
option FORMAT and is followed by the number of the sector increment. 
Normally the default increment value is used (1) which causes a one-to-one 
mapping of physical sectors in a track to logical sectors. Changing this 
value might improve the disk I/O throughput (or degrade) by causing the 
sectors to be interleaved on a track which, when the rotational speed of 
the disk is taken into account, might optimize the consecutive sector 
read/write time. 

This option has no effect on disks that are "hard sectored". 

LABEL Indicates that you only wish to re-initialize the disk label. You may 
change the label of a disk that is write protected. 

This is the only option which may be specified when the system disk (S) is 
being initialized. If the label of the system disk is changed, the system 
will respond with an error message: "Need System Disk". Enter a system 
restart to reboot. 

NOWP Indicates that any disk write protection on the specified disk is to be 
removed. This option, when specified, must be used by itself. 

SECTOR Indicates the number of sectors per track available on the disk. This 
option requires the option FORMAT and is followed by the number of 
sectors. 

SIZE Indicates the number of directory entries to be allocated in the new 
directory. This option requires the option CLEAR or FORMAT to be in 
effect. The SIZE option is followed by a number which is the desired 
number of directory entries. When this option is not specified a default 
directory size is used which is determined by the capacity of the disk. 
This option is not valid when the system disk is initialized. 

When the size option is used the INITDISK program will allocate at least 

the specified number of entries. More may actually be allocated due to 

requirements of the system. The minumum directory size is determined by 
the format of the disk. 



IHITDISK 
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SKEW Indicates the offset between logical sector zero of one track and logical 
sector zero of the next track. This option requires the option FORMAT and 
is followed by the number of the track skew. Normally the default skew 
(0) is used which indicates that tracks are not skewed. Changing this 
value might improve the disk I/O throughput (or degrade it) when the track 
step- time is taken into account. 

This option has no effect on disks that are "hard sectored". 

TRACKS Indicates the number of tracks per surface available on the disk. This 
option requires the option FORMAT and is followed by the number of tracks. 

WP Indicates that the specified disk is to be write protected. This option 
must be used by itself. When a disk is write protected the operating 
system will not allow any changes to the disk by any of the commands or 
user programs. (INITDISK with option FORMAT ignores any write protection 
on a disk for obvious reasons.) 

It is necessary that a new disk be FORMATted before attempting to write data upon 

When a disk is FORMATed the options SIZE, INCR, SKEW, HEAD, TRACK and SECTOR do not 
have to be specified unless the default values are not correct. These values will 
be displayed before the initialization process begins. If the values are not 
correct respond with a "N" and the program will be exited, allowing you to restart 
and to specify the correct values. 

The actual default values is dependant upon the manufacturer of your computer 
system. 

The option WP for write protection is different from the hardware write protect. 
The hardware write protect is a function of the disk controller and the removal of 
the "write enable" tab on the disk itself. 

While a disk is being initialized the current track number of initialization is 
displayed. 

INITDISK Examples 

>INITDISK A (FORMAT 

INITDISK will erase all files on drive A(2) 
Do you wish to continue (Y/N)? N 
Disk remains unchanged 

>INITDISK A (LABEL) 

Enter disk label: DISKIDX 

>INITDISK A (CL 

INITDISK will erase all files on drive A(2) 
Do you wish to continue (Y/N)? Y 

>INIT B (CLEAR SIZE 32 

INITDISK will erase all files on drive B(3) 
Do you wish to continue (Y/N)? Y 
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>INIT C (FORMAT SIZE 8 

INITDISK will erase all files on drive C(4) 
Do you wish to continue (Y/N)? Y 

Enter disk label: TEST 

Number of directory entries = 32 
Increment between adjacent sectors = 1 
Offset between adjacent tracks = 
Number of surfaces r 1 
Number of tracks/ surface a 77 
Number of sectors/ track =13 

Is above information correct (Y/N)? Y 

Track: 

> 
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IHITTAPE COMMAND 

The INITTAPE command allows you to initialize a tape for use or re-use by the OASIS 
operating system. The format of the INITTAPE command is: 

JffllHAPE [<TAPEn>] C«option>[)]] 

Where : 

TAPEn Indicates the tape drive containing the tape to be initialized, n must be 
in the range of 1 -4. When TAPEn is omitted or n is not specified TAPE1 
is assumed. 

IHITTAPE Option 

TENSION Indicates that you only wish to re- tension the tape. Tensioning a tape 
involves winding the tape to the end-of-tape mark and then rewinding to 
the begin-of-tape mark. It is advised that a tape be tensioned before it 
is first used or re-used. 

When the TENSION option is not specified the tape will be formatted by writing a 
label on all tracks of the tape. A tape label consists of an eight character 
volume id and a fourteen character owner id. The volue id used will be the label 
displayed by BACKUP, ARCHIVE, and RESTORE when the tape is accessed. The owner id 
is not referenced by the OASIS operating system and may be left blank. 

INITTAPE Example 

>INITTAPE (TENSION 

>INITTAPE 

Enter volume id (8 chars) ? BACKUP$S 

Enter owner id (14 chars) ? REMARK 
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LIST COMMAHD 

The LIST command allows you to display data files on the console or the system 
printer. The format of the LIST command is: 

LIST <file-desc> [(<option>...[)] 

Where : 

file-desc Indicates the file description of the file to be listed. Although the 
file disk may be omitted, wildcards may not be used. 

The file may not be a binary program file and should not be a BASIC 
compressed file (file type BASICOBJ or BASICCOM) . 

LIST Options 

Options for the LIST command include the following: 

FORMAT Indicates that the file contains ANSI forms control characters. Refer to 
the appendix on ANSI forms control. 

HEADING Indicates that the listing is to include a heading. This is a default 
option. The standard heading, when specified, includes the file name, 
file type, file disk label, current system time and date, and the page 
number . 

£NDENT n Indicates that the listing is to be indented nn columns from the left 
margin. If this option is omitted then the listing will be displayed 
starting with column 1 . 

LOWC ASE Indicates that all lower case characters are to be displayed "as is" 
without any translation. This is a default option. 

NOHE AD Indicates that the listing is not to include a heading. 

PAGE nn Indicates that the output of the listing is to be suppressed until page 
number nn is started. 

PRINTER[n] Indicates that the list is to be output to the printer specified. If n 
is not specified PRINTER 1 is used. 

TITLE text Indicates that the listing is to include an alternate heading 
consisting of the text followed by the current system time, date and the 
page number. This option, when used, must be the last option specified as 
all characters following » TITLE 1 will be treated as the text to the title. 
Any words in text will be truncated to eight characters by the CSI. 

TRUNC nn Indicates that each line of data is to be truncated at column nn. The 
data truncated will not be listed on the next line. 

TYPE Indicates that the list is to be output to the console. This is a default 
option. 

UPCASE Indicates that all lower case characters are to be "folded" to their upper 
case equivalents. 

The following two options may only be specified when the file is a sequential 
access file. 

red Indicates that the list of the file is to start with this record number. 
This field must be numeric. When red is greater than the number of 
records in the file no records will be listed. When this field is omitted 
1 is assumed and recn cannot be specified. 

recn Indicates that the list of the file is to end with this record number, 
inclusive. This field must be numeric or f * f and, when specified, must 
follow the specification of red. When this option is not specified or is 
specified as an asterisk the list will continue until the end of the file 
is reached. 

Sequential format files are listed, one record per line (unless FORMAT option is 
specified). Direct and indexed format files are listed in a special format. 

For these files the key (ASCII key for indexed, record number for direct) is listed 
followed by a colon, space. The remainder of the record is then listed, taking as 
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many lines as needed. The record contents will always be indented from the key. 

Formatted records (records created with the WRITE statement in BASIC) will be 
displayed with a comma separating each field of the record. 

Files that have READ protection cannot be listed with this program (see RENAME 
command) . 

LIST Examples: 

>LIST TEST. OBJECT (NOHEAD 

10 P 00 005C TEST 01 0100 
15 T 00 0100 2146013610121470136007EFE09D21901 
15 T 00 0110 2146017EB7C20001FF5F160021480119 
15 T 00 0120 194E7 9234623 96577823 9EDDA3F01B2CA 

• 

02 Z 00 1A1A 

>LIST DATA. FILE (NOHEAD ; INDEXED FILE 

This is record 1: ONE, TWO, THREE, FOUR 
This is record 2: ONE, TWO, , FOUR 
This is record 3: ONE, TWO, THREE, FOUR 

>LIST SYSTEM. ERRMSG:S ( NOHEAD ; DIRECT FILE 

Syntax error. 
File name missing. 
File type missing. 
Drive code missing. 



>LIST SYSTEM. DEVN AMES :S (1 5 J SEQUENTIAL, UNFORMATTED FILE 

SYSTEM. DEVNAMES: SYSTEM 06/21/81 12:49 Page 1 

FL0PPY1 1 D 1 2 3 4 
FL0PPY2 2 D 1 2 3 4 
FL0PPY3 3D 1 23 I 
FL0PPY4 4 D 1 2 3 4 
HARD1 5 D 5 6 7 8 

> 



1: 


:i; 


2: 


.2, 


V: 


[I. 
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LOAD COMMAHD 

The LOAD command is only available on multi-user OASIS. 

The LOAD command loads a re-entrant program for subsequent usage. The format of 
the command is: 

isQAD <file-desc> 

Where i 

<file-desc> Indicates the re-entrant program to be loaded.. When no file type is 
specified the default type of LOADFILE is used. When no file disk is 
specified the system disk will be searched first. 



This command may only be used in a single user environment (no user partitions j 
defined — see SET command). 



Before a re-entrant program may be used by multiple users the program must first be 
loaded into memory with this command. 

Up to eight re-entrant programs may be loaded at one time. 

After the re-entrant program is loaded with this command another program could be 
executed that checks to see if there is a re-entrant copy, and acts accordingly. 
An example of this is the BASIC. LOADFILE and the RUN. COMMAND. The RUN command, 
when invoked by the CSI, is loaded and executed. One of the first operations that 
it performs is to ask the operating system if BASIC has been loaded. If it has 
then it transfers control to it and releases its own memory for use by the 
re-entrant BASIC. If BASIC was not loaded then it continues operation as a 
non- re-entrant program. 

Do not load a re-entrant program unless it is to be used — all user's available 
memory would be reduced un-necessarily. 
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LOGOFF - LOGOH COMMANDS 

LOGOFF Command 

The LOGOFF command provides the primary means of changing accounts in the system. 
The format of the command is: 

iaQGQFF 

When the LOGOFF command is executed the current account is logged off. The log off 
process entails many things: if the HISTORY switch is set on a history record is 
written to the SYSTEM. HISTORY file recording the log off time and elapsed logon 
time of the account; all privately attached devices are detached; all public disk 
are re-attached drive A being attached to lowest disk number, B to next lowest disk 
number, etc.; all user switches (SET command) are reset to the sysgened status; and 
control is transferred to the LOGON command described next. 

LOGON Command 

The LOGON command provides the only means of changing accounts in the system. The 
format of the command is: 

LOGON <acct-name> 

Where : 

ace t- name Indicates the user account name to be logged on to. 

When the LOGON command is executed an automatic LOGOFF is performed on the current 
account. This automatic LOGOFF is different from your execution of the LOGOFF 
command in only one area: no history record is written to the SYSTEM. HISTORY file: 
instead, the previous account's elapsed time is transferred to the new account 
being logged onto. 

The program searches the SYSTEM. ACCOUNT file for the account name specified. If 
the account name cannot be found the program will return to the "Logon please:" 
question. 

When the account name is found in the SYSTEM. ACCOUNT file and the account requires 
a password (not all accounts do) but the operator has not entered one yet, the 
program will ask for it: 

Password? 

The password entered will not be displayed on the console — asterisks will be used 
for each character typed. 

If the password is incorrect the program will return to the "Logon please:" 
question. 

When the account name and password are correct you will be logged onto the new 
account. This logon process entails many steps: the account name, number t and 
privilege level are recorded in the system communication region (SCR); if the 
HISTORY flag is set on a record of the logon will be written to the SYSTEM. HISTORY 
file: the SYSTEM. ERRMSG file is searched for message numbers 99 through 102 and 
displayed if found; the system disk is searched for the file SYSTEM. LOGON and 
displayed when found; the logon date and time are displayed on the user's console. 
At this time the user is logged on to the account specified and may only access 
public files and programs, his own private files and programs, and any files and 
programs that he has shared access to (see "User Accounting" and "SHARE Command" 
chapters in this manual). 

A search is made of all attached directories for an EXEC program with the file 
description <acct-name>.EXEC. When this file is found it is executed. If the file 
cannot be found then control of the system returns to the CSI level. 

I The LOGON command will not allow you to log onto an account that is already in use j 

by another user. This applies only to the account name, therefore you may log onto 
J a synonym of an account in use by another user. ! 

Note the reference to the file SYSTEM. LOGON above. This file should be an ASCII 
sequential file ('editable 1 ) that is used to convey messages to all users that log 
onto the system. 
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LOGOS & LOGOFF Examples 

>LOGOFF 

Logoff at 12:23:15, on 02/07/81, ET = 122.68 

Logon please: NAMES 

Password? ****** 

Logon at 12:23:20, on 02/07/81. 

>L0G0N USEE 

Logon at 12:24:10, on 02/07/81 

>L0G 

Logoff at 13:12:10, on 02/07/81, ET = 15.24 

Logon please: NAMES,****** 

Logon at 13:12:15, on 02/07/81. 

> 

Note that the logon procedure is slightly different when performed following a 
LOGOFF. This is due to the fact that after the LOGOFF is executed there is no 
account logged on and the system will force the operator to log onto a valid 
account, when the LOGON command is executed and there is an error in the account 
or password the previous account is still logged onto the system. 
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MAILBOX COMfAMD 

The MAILBOX command is only available on multi-user OASIS. 

The MAILBOX command allows you to retrieve messages sent to you while you were 
unable to receive messages. The format of the command is: 

MAILBOX 

The MAILBOX command only displays message sent to the account name that you are 
currently logged on to. Once you have retrieved your messages the system's message 
file is updated so that you will not display those messages again. 

MAILBOX Example 

>LOGON TED 

You have messages waiting. To retrieve, execute MAILBOX. 

>MAILBOX 

From: TODD, 09:58 10/19/79 

Sorry I missed you. I copied all of the programs you requested 

to your account. Hope that they will do the job. 

From: SYSTEM, 10:15 10/19/79 

Please turn in all of your log sheets, to date. 

From: MANAGER, 10:30 10/19/79 

The system will not be available tomorrow, the 20th, due to installation 

of additional disk capacity. 
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MOUNT COMMAND 

The MOUNT command allows you to inform the system that a 
The format of the MOUNT command is: 



disk is to be changed, 



MOUNT <fd>j« 



Where : 

fd 

* 



Indicates the label of the directory that is to be changed. 

Indicates that all attached disks may have been changed. (System disk (S) 
excepted). 



This command informs the system that a disk has been changed. The system maintains 
a copy of each disk ID that is attached. This provides a safeguard to the user in 

Preventing disk changes during updates, etc. If a disk is changed and this command 
as not been executed a disk error will occur: "Disk Changed". When this message 
is displayed and if it is acceptable for the disk to have been changed then you may 
respond with an f M f , which will cause a mount to be performed on the drive. 

The system disk (fd = S) may not be changed at any time without re-booting the 
system. This is due to the fact that once a system disk has been booted several 
internal pointers in the operating system have been set. Resetting these pointers 
is essentially what occurs when the system is re-booted. 

Caution: The MOUNT command must be used when a change is made from a single density 

disk to a double density disk or from a double density disk to a single density 

disk. When such a change is made and the MOUNT command is not used the first 
access to the changed disk may cause the system to "hang". 



Note: Not all systems have the ability to detect a 
function of the disk drive and controller. On systems 
the MOUNT command will have no effect. 



changed disk. This is a 
that lack this capability 



MOUNT 
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HSG COMMAND 

The MSG command is only available on multi-user OASIS. 

The MSG command provides a means of sending a message to another user. The format 
of the command is: 



MSG <pin> <text> 



Where : 



<pin> Indicates the partition identification number or the user name that the 
message is to be sent to. A pin of * indicates that the message is to be 
sent to all logged on users, including the sender. You may only broadcast 
a message to all users if you have a privilege level of five. 

<text> Is the message to be sent. When <text> is omitted the MSG command will 
allow you to enter multiple lines of text with the message terminated by a 
blank line. 

When the MSG command is executed the message specified by <text> will be displayed 
on the user f s console specified by <pin>. It is possible that this cannot be done. 
In this situation one of several messages may be displayed on your console: 

Can't send message to your self . 

User is not receiving messages. 

User is not logged on. 

In the latter situations where the receiving user is not logged on or has his 
message switch set off (see SET MSG command) then the MSG command will ask you if 
you wish to put the message in the user's mailbox. (See MAILBOX command.) 

MSG Example 

>MSG 2 Please load the invoice forms in the printer. (Send msg when done.) 

User is not logged on 

Do you wish to deposit into the mailbox? N 

>MSG TOM Would you please send me a message when you log on? 

>MSG * 

Enter message text, terminate input by empty line. 

?System reverting to single user mode at 

?5:30 for backup purposes. Please be logged 

?off by that time. 

From: SYSTEM 

System reverting to single user mode at 
5:30 for backup purposes. Please be logged 
off by that time. 
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OtfHERCHG COHMAHD 

The OWNERCHG command provides a means of transferring 
or group of files. The format of the OWNERCHG commanc 



account 
is: 



OWHERCHG <file-desc> (<acct-naae> [<option> 



ownership of a file 



Where : 



file-desc Indicates the file description of the file or group of files whose 
ownership is to be transferred. Only the current account's private files 
may be changed with this command. Wildcards are acceptable. 

<acct-name> Indicates the account name that the files are to be transferred to. 
Account names are validated against the SYSTEM. ACCOUNT file. Invalid 
names are rejected with no changes made to any files. 

OWNERCHG Options 

NOQU ERY Indicates that the operator is not to be queried on a file by file basis. 
This is a default option when the file description is explicit. When this 
option is not specified and the file description is non-explicit (uses 
wildcards) the file description of each file matching the description will 
be displayed on the console and the operator is asked (queried) if the 
file is to have its ownership changed. A response of "Y" indicates yes 
and a response of "N" indicates no. 

NOTYPE Indicates that the results of the operation are not to be displayed on the 
console. When this option is not specified the message "<file-desc> 
changed" is displayed for each file whose ownership is changed. 

CJUERY Indicates that the operator is to be asked (queried) for confirmation 
before each file qualifying is changed. This is a default option unless 
the file description is explicit (no wildcards). 

TYPE Indicates that the results of the operation are to be displayed on the 
console. 

Examples: 

>0WNERCHG MYFILE. BASIC :S (MINE 

File "MYFILE. BASIC :S" is now osed by account "MINE". 

>OWNERCHG *. BASIC: A (YOURS 

AARDVARK.BASIC:A Okay to change owner (Y/N)? Y 

File "AARDVARK.BASIC:A" is now owned by account "YOURS". 

BINARY. BASIC: A Okay to change owner (Y/N)? Y 

File "BINARY. BASIC: A" is now owned by account "YOURS". 

SATURDAY. BASIC: A Okay to change owner (Y/N)? Y 

File "SATURDAY. BASIC: A" is now owned by account "YOURS". 

APPLE. BASIC: A Okay to change owner (Y/N)? N 
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PATCH CGMMJLHD 

The PATCH command provides a means of implementing minor corrections to errors in 
object programs, such as the system programs. The format of the PATCH command is: 

MTCH <file-desc> 

The file specified by file-desc cannot be write protected and it must be a program 
file (absolute or relocatable in format). When the PATCH command is executed the 
specified program file is read into memory the PATCH prompt character (\) is 
displayed. At this time there are five subcommands available to the operator in 
addition to a HELP command. 

All addresses and numeric values specified in the following subcommands must be 
hexadecimal in format. 

30.1 Dump Subcommand 

The Dump subcommand displays portions of the program on the console. The format of 
the subcommand is: 

DUMP addrl Caddr2] 

Addrl specifies the beginning address to display. Addr2, when specified, indicates 
the ending address to display. When addr2 is not specified sixteen addresses will 
be displayed. 

The Dump subcommand always displays the program in lines of sixteen addresses each. 

30.2 End Subcommand 

The End subcommand indicates that the "patch" is complete and the program is to be 
written back to disk. The format of the subcommand is: 

EMD 

or 

FILE 

30.3 Help Subcommand 

The Help subcommand displays a simple help message that is a summary of this 
chapter. The format of the subcommand is: 

HELP 

30.4 Quit Subcommand 

The Quit subcommand indicates that the "patch" is to be ignored and that control is 
to be returned to the operating system. The format of the subcommand is: 

QUIT 

30.5 Beplace Subcommand 

The Replace subcommand specifies that the contents of an address is to be changed. 
The format of the subcommand is: 

REPLACE addr value [value]... 

Addr indicates the first address to be modified by the list of values. When more 
than one value is specified or if the value is a character string, the values 
replace the contents of the addresses following addr. 

The list of values may be of three types: 8 bit numeric, 16 bit numeric, or quoted 
character string. For example: 

8 bit numeric: 5 15 A0 3F 

16 bit numeric: (3900) (9F00) (1234) 

character string: 'Syntax error* 
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30.6 Verify Subcommand 

The Verify subcommand allows you to verify the current contents of addresses. The 
format of the subcommand is: 

IERIFT addr value [value]. .. 

This subcommand is similar to the Replace subcommand except that the values are 
used for verification, not replacement. 

30.7 Address Calculations 

Addresses specified to the PATCH command may consist of simple arithmetic 
expressions using the operators +. -, *, /, and @ which correspond to the 
operations of addition, subtraction, multiplication, division, and indirect 
addressing. 

Parenthetical expressions are not allowed and the only hierarchy is left to right 
analysis. The commercial at (§) operator is a post-fix operator only, that is, it 
may only be used following a value. 

Examples of address calculations follow: 

1 00@+34 34H is added to contents of location 100H 
123+5b*2 The sum of 123H and 56 H is multiplied by 2 

PATCH Example 

>PATCH SAMPLE. COMMAND :S 
WERIFY 4900 C3 03 8F 
\REPLACE 4901 05 
\DUMP 4900 

4900: C3058FFD 21519UF E121235A E5211C54 ? !Q[ .. !#Z. ! .T» 

\END 
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PEEK COHMAHD 

The PEEK command is only available on multi-user OASIS. j 

i 
The PEEK command allows you to see what another user is doing by copying his 
console output to your console. The format of the command is: 



EEEK <pin> 



Where : 



<pin> Indicates the partition identification number or user name of the user to 
be peeked at. 

When the PEEK command is executed all output to the specified user's console will 
be echoed to your console. If the user's console uses different screen control 
characters than yours the output may appear "funny". 

While the PEEK command is operating only the system control keys will be 
acknowledged from your console. The only way to exit from the PEEK command is to 
enter the System Cancel-key. 

The PEEK command should not be used to monitor another terminal for a long period j 
of time as the system response does degrade. j 
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RENAME COHMAHD 

The RENAME command allows you to change the filename, filetype, or protection 
status of your own private file or group of files. The format of the RENAME 
command is: 



Where : 
old-fd 



new-fd 



JWPAME <old fd> [<new fd>] [«option> ...[)]] 



Indicates the current file description of the file or group of files to be 
renamed. Wildcards are acceptable. 

Indicates the new file description to be assigned to the file or group of 
files qualifying to old-fd. Equal signs are acceptable for the components 
of the file description. The file disk must be an equal sign or the same 
file disk as specified in old-fd. 

When this parameter is not specified only the protection status of the 
file(s) may be changed. Protection statuses may not be changed when 
new-fd is specified. 



REBAME Options 



DELETE 

NODELETE 
NOQUERY 



NOTYPE 

NOWRITE 
&UERY 

READ 



Indicates that the file is to have DELETE or erase protection. A file 
with DELETE protection may not be erased or renamed without first changing 
the protection status. 

Indicates that the file is to have any DELETE protection removed from it. 

Indicates that the operator is not to be queried on a file by file basis. 
This is a default option when old-fd is explicit. When this option is not 
specified and the old-fd is not explicit (wildcards used) the file 
description of each file matching the old-fd is displayed on the console 
and the operator is asked (queried) if the file is to be renamed. Any 
response other than an n N n will be interpreted as meaning yes. 

Indicates that the results of the operation are not to be displayed on the 
console. When this option is not specified the new-fd of each file 
renamed is displayed on the console. 

Indicates that the file is to have any WRITE protection removed from it. 



Indicates that the operator is to be 
before each file qualifying is renamed, 
the file specification is explicit. 



asked (queried) for confirmation 
This is a default option unless 



Indicates that the file is to have READ protection. A file with READ 
protection can only be accessed by the RUN command. This protection mode 
cannot be removed from a file. Since the READ protection mode cannot be 
removed it is advised that the programmer maintain an archive copy of the 
program in case any modifications need to be made to the program. A 
program file with READ protection cannot be LISTed, EDITed, DUMPed, MOVEd, 
SCRIPTed. COPYFILEd (except in its entirety), or loaded by the BASIC 
interpreter. 

It is not necessary to specify WRITE protection in addition to READ 
protection as a file with READ protection cannot be accessed by any 
commands or functions that might try to write to the file. 



A file with READ protection may be deleted. 

TYPE indicates that the results of the operation are to 
the console. 



be displayed on 



WRITE Indicates that the file is to have WRITE protection. A file with 
WRITE protection may not be updated without first changing the protection 
status. A file with WRITE protection may still be erased. To prevent 
this you should also specify the DELETE option. 

Note: Do not use this command to change the file type * of a BASICOBJ or BASICCOM 
program file— the file will be renamed properly but will be unusable to BASIC. 
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RENAME Examples 

>RENAME TEST. BACKUP: A =. BASIC 
TEST. BACKUP: A renamed TEST. BASIC: A 

>RENAME AARDVARK.BASIC:A (READ 

AARDVARK.BASIC:A protection: NODELETE, NOWRITE, READ 

>RENAME TEST.*:S (NODELETE NOW 

TEST. COMMAND :S Okay to change protection (Y/N)? Y 
TEST. COMMAND :S protection: NODELETE, NOWRITE 
TEST. OBJECT: S Okay to change protection (Y/N)? N 
TEST. ASSEMBLE: S Okay to change protection (Y/N)? N 
TEST.BASIC:S Okay to change protection (Y/N)? Y 
TEST. BASIC'S protection: NODELETE, NOWRITE 
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The RESTORE command provides the ability to retreive archive copies of a file, 

froup of files, entire account, or disk volume onto another disk or set of disks, 
he Format of the command is: 

RESTORE [<fn> <ft>J <fd1> <fd2> [(options [)■]] 

Where? 

<fn> Indicates the file name to be restored (wildcards are allowed). 

<ft> Indicates the file type of the file to be restored (wildcards are 
allowed). 

<fd1> Indicates the disk drive label or the tape drive name (TAPE1, TAPE2, etc.) 
that contains the file(s) to be restored. 

<fd2> Indicates the disk drive label of the drive that is to receive the 
restored files. Notice that both <fd1> and <fd2> are required fields and 
that wildcards are not allowed for these parameters. 

RESTORE Options 

ACCOUNT This option specifies that only those files that are owned by the current 
account are to be restored to the current account. This is a default 
option when <fn> and <ft> are specified. 

ASK This option specifies that two questions are to be asked of the operator 

before the restore is to begin. These questions allow the operator to 

confirm that the proper disK or tape is being restored to the correct 
disk. This is a default option. 

NEWAC C xxx This option specifies that only those files that are owned by the 
account xxx are to be restored to the current account. 

NEWFILE Indicates that files are to be restored only when there are no existing 
files by the same description in the owning account. This is a default 
option. 

NOASK This option suppresses the questions that are normally asked before the 
restore process starts. The purpose of this option is to allow 
programmers to design systems with their own controlled interface to the 
operator. 

NOQUERY Indicates that the operator is not to be queried on a file by file basis. 
This is a default option. 

NOTY PE Indicates that file descriptions of files restored are not to be displayed 
on the console. 

NOVE RIFY Indicates that no read after write verification is to be performed. 

OLDFILE Indicates that files are to be restored only when there is an existing 
file by the same description in the owning account. 

OJJERY Indicates that the operator is to be queried for each archived file that 

matches any qualifying options specified. A response of Y is required to 

restore a file; a response of N or carriage return is required to continue 
to the next file query. 

REPLACE Indicates that files restored are to replace any existing file in the 
owning account. 

TYPE This option causes the description of each file restored to be displayed 
on the console. This is a default option. 

XERIFY Specifies that a read after write verification is to be performed for each 
file restored. This is a default option. 



VOLUME Indicates that the entire archive volume(s) is to be seached for 

st those files owned by the cur: 
no <fn> and <ft> is specified. 



qualifying files to be restored, not just those files owned by the current 
account. This is a default option when n< 



When the restore is from a multi volume set of archive disks the RESTORE command 
requires that the volumes be loaded one at a time, in sequence. As each volume is 
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used the program will request the next volume, by number, to be loaded into the 
source drive. 

RESTORE Examples 

>RESTORE B A (NOTYPE 

Source on drive B(3) 
Destination on drive A(2) 
Mount volumes now - 

Source disk is labeled "ARCHA001" 

Destination is labeled "DATA n 

Archive is from disk "DATA " on 01/12/80 at 16:22:35 

Ok to start restore (Y/N)? Y 

>REST0RE TEST.BASICOBJ:A B (NOASK 

Searching for account "SOURCE" 

TEST.BASICOBJ:A restored to TEST. B ASIC OBJ :B 

>REST0RE DATA. FILE: TAPE S (NOASK NOTYPE 

Searching for account "SYSTEM" 

> 
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SET CGMMAHD 

The SET command allows you to change various system parameters and options. The 
format of the SET command is: 

£ET <function> <status> 

Where: 

function Indicates one of the system functions or parameters that the SET command 
may alter. 

status Indicates the status or condition that the function is to be set to. 

SET Functions 

The various functions that the SET command may alter are defined as follows: 

SET ABBREV OH S OFF 

This function allows the user to change the status of the switch that allows 
commands to be abbreviated. Normally commands are allowed to be abbreviated. 

For a description of the effects of changing ABBREV and SYN refer to the chapter on 
the Command String Interpreter, CSI Program Search Sequence section. 

SET BAHK nn 

The SET BANK function is only operative on those systems that have user 
programmable memory bank size capability. When this is the case this function 
allows the user to specify the size of the common or global bank of memory. This 
bank of memory is common because it is always available to the system independant 
of the current bank number enabled. 

The values that may be used with this function are: 16, 32, and 48 indicating that 
the global memory is to use the first 16K, 32K, or 48K of memory respectively. 

SET CAHCEL nn 

This function is similar to the SET ESCAPE function except that it operates on the 
line cancel key. 

SET CLKFRQ nn1 [nn2] 

This function requires privilege level of 5 and provides an easy means for the user 
to fine tune the time of day clock. If, for whatever reason, the time of day is 
not accurate, this function may be used to adjust the physical interval of time 
between "ticks" of the clock. The two values nn1 and nn2 are used for gross and 
fine adjustments, respectively. Any values entered will replace the current values 
so it is advised that you use the SHOW CLKFRQ command to determine the current 
values first before adjusting them with the SET CLKFRQ command. 

Decreasing the value of either or both parameters makes the time of day clock run 
faster — Increasing the value of either or both parameters makes the time of day 
clock run slower. Decreasing one parameter and increasing the other parameter will 
have a combined effect on the speed of the time of day clock. 

SET DATE mn/dd/yy 

This function requires privilege level of 5 and allows the user to change the 
system date. mm/dd/yy indicates that the user types the month, day, and year that 
he wishes the system date set to. 

Leading zeros are not required and the slash (/) delimeter may be replaced with any 
of the following characters ./-+*: !"#$$&»=§ x <>? 

SET DATEFORM 1 |2l3 

This function allows you to set the format of the date display. The format set by 
this function will be reflected in the headings of listings, logon history, initial 
date set on system start, etc. 

Format 1 mm/dd/yy 01/31/80 
Format 2 dd-mm-yy 31-01-80 
Format 3 ddmmmyy 31JAN80 
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SET DEUTSCH OS S OFF 

This function is provided to assist in the interface of foreign language terminals 
to OASIS. When this function is set ON and the console input casemode is upper the 
following character translates are performed: [-},-!,]-}. The console input 
casemode is upper when the CSI is in control, or by specifying CASE U in the system 
editor, or by specifying OPTION CASE »U» in BASIC. 

The character translation offered by this function is relatively useless with an 
English language (ASCII) keyboard but is quite meaningful with a German language 
keyboard as the characters translated affect the three additional letters that are 
added to the keyboard to display those characters with umlauts. 

SET DOHH nn 

This function is similar to the SET ESCAPE function except that it operates on the 
down-arrow key. 

SET ERRNTJM OH J OFF 

This function requires privilege level of 5 and allows the user to set the error 
number display ON or OFF. When a system program detects an error the error is 
reported to the operator in one of three ways: error number and text; error number 
only: error text only. This function will either turn ON or OFF the error number 
display. If you are turning the error number display OFF and the error text 
display is already OFF then the error text display will be set ON. (It is not 
allowed to turn both methods of displaying errors OFF.) 

SET ERRTEXT OH J OFF 

This function requires privilege level of 5 and allows the user to set the error 
text display ON or OFF. When a system program detects an error the error is 
reported to the operator in one of three ways: error number and text: error number 
only: error text only. This function will either turn ON or OFF the error text 
display. If you are turning OFF the error text display and the error number 
display is already OFF. then the error number display will be set ON. (It is not 
allowed to turn both methods of displaying errors OFF.; 

Refer to the Appendix on System Errors for details on error display. 

SET ESCAPE nn 

This function allows the user to set the value of the character to be interpreted 
as the escape character from the console keyboard. Some terminals use the escape 
character for their own uses and do not transmit the charcter to the host computer. 
By using this function you can designate another character to be used as the escape 
character, leaving the escape key for the exclusive use of the terminal. The value 
nn corresponds to the ASCII value of a key. For example if a CONTROL/Y is to be 
used the value is 25. 

SET HISTORY (WjOFF 

This function requires privilege level of 5 and allows the user to change the 
status of the switch that determines whether history records are to be created for 
each user logon and logoff. When history record creation is suppressed by setting 
this switch off the LOGON and LOGOFF commands operate somewhat faster because less 
work is done by them. 

SET IMPEXEC OMJOFF 

This function allows the user to change the "switch" that allows a command to be 
the name of an indirect command file (EXEC). 

When IMPEXEC is set OFF, and the user wishes to execute an EXECutive procedure, the 
user must specify that he is doing so by preceding the name of the EXEC file with 
the command EXEC. 

When IMPEXEC is set ON the user need not explicitly specify that he is executing an 
EXECutive procedure unless the name of the EXEC is the same as one of the OASIS 
commands. 

For more information regarding the EXECutive procedure processor refer to the EXEC 
Language Reference Manual. 
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SET IPLASK OH {OFF 

This function allows you to control the time and date input request that occurs 
when the system is first booted or powered on. Since the operation of this 
function only occurs when it is booted you. will have to perform a SYSGEN after 
making a change with this function. 

The IPLASK function should only be turned off if you have added a battery powered 
calendar and time of day clock to your system along with the necessary software to 
make use of the added hardware. 

SET LEFT nn 

This function is similar to the SET ESCAPE function except that it operates on the 
left-arrow key. 

SET MEMORY <pin> [<length> [<bank>]] 

This function requires a privilege level of 5 and allows you to define a partition 
and its size. 

Memory partitions must be allocated in ascending order and deallocated in decending 
order within a bank's memory region. The memory used by the partition is taken 
from or given to the next lowest user within the same bank. When multi-user OASIS 
is first booted into the system there is only one partition (number 1) that owns 
all of available memory (single user mode) in the first bank of memory. 

The SET MEMORY command is used to allocate or deallocate the users. For example, 
if three users are desired, each with 12 thousand bytes of memory the following 
commands might be given: 

>SET MEMORY 2 24000 

>SET MEMORY 3 12000 

At this time there would be three, inactive users with the second two users having 
12000 bytes of memory each and the first user having the rest of memory available. 

If your system has more than one bank of memory you can use the optional parameter 
<bank> to specify which bank of memory the user partition is to be allocated in. 
The first user allocated to a bank gets all of the banks memory (all banks are 
sized when the system is first booted up) . When no bank number is specified the 
default bank of zero is used. 

SET MSG OHjOFF 

This function allows you to specify whether or not you are receiving messages. For 
more information see the MAILBOX and MSG commands. 

SET PRX7 nn 

This function allows you to lower the privilege level, thus restricting the 
commands and functions that you may perform. Normally, this function would only be 
used in single-user OASIS when the accounting feature is not used. (The accounting 
feature allows you to specify a privilege level for each account name.) 

SET QET OMiOFF 

QET stands for Quit Error Trap and relates to the action taken when the System 
Cancel-key is typed. This function of the SET command enables or disables the 

Erocessing of the System Cancel-key. When QET is ON the operator may use the 
ystem Cancel-key to abort the iob being processed. When QET if OFF entry of the 
System Cancel-key is ignored by the operating system. 

SET HDYMSG OHjOFF 

This function allows the user to set the ready message display either ON or OFF. 
When it has been set ON the system will display a "ready message" after the 
execution of every program. This message consists of the return code, current 
system time and the elapsed time of execution. 

This feature of the system can be useful if the user is testing a program that uses 
the return code in a decision making process. 
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SET BIGHT nn 

This function is similar to the SET ESCAPE function except that it operates on the 
right-arrow key. - 

SET RTCAVAIL OM|OFF 

This function should not be changed by the user. It controls a switch set during 
implementation of OASIS on your type of computer. 

SET RUBOUT nn 

This function is similar to the SET ESCAPE function except that it operates on the 
character rubout or delete key. 

SET SLICE nun 

This function requires privilege level of 5 and allows you to change the time slice 
value. The time slice value is the number of 1/1000 of a second (millisecond) that 
each user will have control of the system. 

A typical slice time is in the range of 10 to 50 milliseconds. 

SET SYNOBTM [fn] [(option[)]] 

This function allows the user to change the command synonym table. 

The file name refers to the user defined synonym file. This file must exist before 
the user synonyms may be set ON. As described in the Appendix on System Files this 
file must have a file type of SYNONYM and be a sequential format file on the system 
disk. Specifying a filename causes an automatic CLEAR option to be performed on 
any previously defined user synonym file. 

When a user defined synonym file is specified the user defined synonyms will take 
precedence over any system defined abbreviations. 

The allowed options for the SET SYNONYM command include the following: 

CLEAR Indicates that the user defined synonyms are to be cleared. This 
option does not effect the status of the system defined synonyms. 

NOST D Indicates that the system defined synonyms are to be turned off. 
Since the system defined synonyms are only abbreviations of the 
system commands then this option effectivly sets ABBREV OFF for the 
system abbreviations but not the user defined abbreviations. This 
option has no effect on the user defined synonyms, if any. 

STD Indicates that the system defined synonyms are to be turned on. This 
option has no effect on the user defined synonyms, if any. 

SET TIME hh:nm:ss 

This function requires privilege level of 5 and allows you to change the system 
clock. hhimmiss indicates that you are to type the hours, minutes, and seconds 
that you wish to set the system clock to. Typing the seconds is not required, nor 
are leading zeros. The colon (:V delimiter may be replaced with any of the 
following characters ./-+*: ! n #$5&& » = §<>? 

If you type an invalid or unrecognizable time the SET command will reply: 

Incorrect format, should be l, hh:mm:ss n . 

When a valid time is specified the SET command will ask: 

Enter any char to set the time to (hh:mm:ss) - 

This allows you to specify the exact instant that matches the time to be set, 
independant of how long it might take to execute the command. 

SET TODAVAIL OM|OFF 

This function enables or disables the use of the time of day feature maintained by 
the system. When this switch is set off all programs that are capable of 
displaying the time will not (i.e., FILELIST, LIST, DUMPDISK, SHOW DISK, etc.). 
Note that only the display of the time is affected; maintenance of the time of day 
clock is continued even when the switch is off. 
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SET UP nn 

This function is similar to the SET ESCAPE function except that it operates on the 
up- arrow key. 

SET VERSIOH GH[OFF 

This function allows the user to change the status of the version switch. When the 
VERSION switch is, set on the program name, version number, and version date will be 
displayed upon entry to a program. 

SET Examples 

>SET DATE 5-10.78 

>SET RDYMSG ON 

RC s 0, 12:15:32, ET = 15.3 minutes 

>SET RDYMSG OFF 

>SE ABBREV- OFF 

>SE VERSION ON ; THIS SHOULD NOT ALLOW THE ABBREVIATION 
SE. COMMAND not found. 

>SET ABBREV ON 

>SET ESCAPE 22 
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The SHARE command allows you to designate that a file is to be shared by another 
account. The format of the SHARE command is: 

SOABB <file-desc> [«Type>[)]] 

Where: 

file-desc Indicates the private file whose shared access is to be modified. 

Type Indicates that the current shared access accounts to this file are to be 
displayed on the console. 

When the TYPE option is specified a list of account names that have shared access 
to this file will be displayed on the console. 

When the TYPE option is not specified the SHARE command will allow you to change 
the accounts that have shared access to the file specified. 

The program will ask "Add user account?". If an additional account is to be 
allowed shared access to this file then enter the account name and the question 
will be asked again for additional accounts. When no account name is entered in 
response to this question the next question will be asked. Do not specify a system 
account name as an account to have shared access. When a file is snared with 
another account it is also shared with all of that account's synonyms. 

The programs will ask "Delete user account?", if an account that currently has 
shared access to this file is to be denied access then enter the account name and 
the question will be asked again for additional accounts. When no account name is 
entered in response to this question the program will return control to the CSI. 
It is not necessary to delete shared access to synonyms of an account that is 
having its shared access deleted. This is done automatically by the method that 
the system uses for synonym accounts. 

SBABE Examples 

>SHARE MYFILE.DATA:A 

Add user account? ALPHA 
Add user account? OMEGA 
Add user account? 
Delete user account? BETA 
Delete user account? 
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SHOT CCHMAMD 

The SHOW command provides you with the ability to display the status of certain 
system parameters. The format of the SHOW command is: 

SggOf <function> 

SHOW Functions 

The various functions available with the SHOW command include the following? 

igBREV Display the status of the abbreviation switch. 

SANK Display the current usable banks and sizes. 

£A1£CEL Display the currently defined console keyboard line-cancel character . 

JSyCFRQ Display the current clock frequency adjustment constants. 

£LOCK Display the system clock continuously. To exit from this mode you must 
use the system cancel-key. 

Note: Your system may not support the time of day feature. 

DATEFO RM Display the current date format. 

DEUT SCH Display the status of the German keyboard switch. 

£ISK Display the status of all attached disks, or, when followed by a disk 
specification, the status of the specific disk. 

DQWN Display the currently defined console keyboard down-arrow character. 

ERRNU M Display the status of the error number switch. 

ERRTE XT Display the status of the error text switch. 

Jg§£APE Display the currently defined console keyboard escape character. 

IXSTORY Display the status of the history switch. 

IMPEXEC Display the status of the implied EXEC switch. 

IPLA SK Display the status of the IPL ask switch. 

ULFT Display the currently defined console keyboard left-arrow character. 

MEMORY Display the the current allocation and usage of memory. The information 
displayed includes the partition identificatin number (Port), activity 
flag and memory bank number (Bank), partition start address (MEMLO) , 
partition end address (MEMMX) , current partition high memory (MEMHI) , 
current partition stack pointer (SP), current partition execution address 
(PC) r partition size, in decimal (Size), command name being executed by 
partition (Routine), user name logged onto partition (Username). 

The activity flag under the Bank column will have one of five available 
values: 

blank Partition is active and executing a program. 

1 Partition is waiting for a shared resource. 

2 Partition is waiting for an interrupt. 
4 Partition is waiting for the disk. 

8 Partition has not been started. 

MgMORY £ Causes the SHOW MEMORY display to be displayed continuously on the console 
screen with an updated display approximately once per second. To abort 
from this function you must use the System Cancel-key. 

MSG Display the status of your message receiving switch. 

PgHLEV Display your current maximum privilege level. 

QET Display the status of your quit error trap switch. 

.RDYJiSG Display the status of the ready message switch. 
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RIGHT Display the currently defined console keyboard right-arrow character, 
RTCA VAIL Display the status of the real time clock available switch. 
U2EPUT Display the currently defined console keyboard rubout character. 
SER IAL Display the serial number of the operating system. 



i SLI CE Display the current system time slice value. ! 



SYNO NYM Display the synonyms currently defined. Any system defined abbreviations 
will be displayed first followed by all of the user defined synonyms and 
abbreviations. 

JJME Display current system time and date. 

Note : Your system may not support the time of day feature . 

TODA VAIL Display the status of the time of day available switch. 

HE Display the currently defined console keyboard up-arrow character. 

USERS Display the users that are currently logged onto the system. The 
information displayed includes the partition numberr, account name, and 
logon date and time. 

VERSION Display the version number, version date, and the privilege value of all 
command programs on the specified disk. When no disk is specified the S 
disk is assumed. 

WHO Display the account name of the account that you are currently logged 
onto. 

*. Display the current time and date, the memory size of your partition, and 
the status of: ABBREV, CANCEL, DATEFORM, DOWN. ERRNUM, ERRTEXT, ESCAPE, 
HISTORY. IMPEXEC, IPLASK. LEFT. MSG, PRIVLEV, QET, RDYMSG. RIGHT, 
RTCAVAIL, RUBOUT, SERIAL, SLICE, SYNONYM, TODAVAIL, UP, and VERSION. 

Note: Your system may not support the time of day feature. 

SHOW Examples 

>SHOW RDYMSG 
RDYMSG = OFF 

>SHOW ABBREV 
ABBREV s ON 

>SHOW IMPEX 
IMPEXEC = ON 

>SHOW DISK S 

S(1) Label: "SYSTEM ", 

Backup onto "SYSTEMS" on 04/17/80 13:12, 

Capacity: 497K bytes, (77-1-26) , 

Available: 56K bytes (11*), 

Largest area: 56k bytes, 

95 riles is use (out of 176). 

The information displayed by the SHOW DISK function is: 

Line-1 Directory label; drive number; disk label; write protect status. 

Line-2 Backup disk label; backup date and time. 

Line-3 Disk capacity; number of cylinders; number of heads; number of sectors per 
track. 

Line-4 Amount of storage available; percent available. 

Line-5 Largest amount of contiguous storage available. 

Line-6 Number of files in directory; total number of directory entries allocated. 
This is a reflection of all files on the disk, not just the files 
accessible from the current account. 
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The SHOW DISK function, in addition to displaying the above information, 
also validates the allocation of the disk. If any misallocation is 
detected an error message is displayed. Negative misallocation indicates 
that more space has been allocated for file storage than is actually in 
use. Positive misallocation indicates that less space has been allocated 
than is actually in use. These are dangerous conditions - the disk should 
not be used until the misallocation is corrected. The positive 
misallocation indicated that at least two files are sharing the same disk 
space. Any misallocation may be corrected by copying all of the files to a 
blank disk* one file at a time. If positive misallocation existed then one 
or more files may contain invalid data. 

The following version numbers and dates do not necessarily reflect the current 
version number for the system programs. 

Priv 
5 



3 
2 

3 
1 
1 
4 
2 



>SHO¥ VERSION 




Module Version 


Date P: 


ACCOUNT 5.4 


1 8FEB80 


ASSIGN 5*4 


04JAN80 


ATTACH 5.4 


04JAN80 


BACKUP 5.4 


04JAN80 


BASIC 5.4B 


06JAN80 


CHANGE 5*4 


21JAN80 


COPYFILE 5.4 


1 9FEB80 


CREATE 5.4 


05FEB80 


DEBUG 5.4 


26DEC79 
04JAN80 


DUMPDISK 5.4 


>SHOW SYNONYM 




System User 


Shortest 


Command Synonym 


Form 


aSign 


AS 


ATTACH 


AT 


BACKUP 


BAC 


COPYFILE 


C 


CREATE 


CR 


DUMPDISK 


DU 


EDIT 


E 


ERASE 


ER 


EXEC 


EX 
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>SHOW * 

SHOW ver 5.5 06NOV80 

NAME = SYSTEM 
[ PORT =1 \ 

ABBREV = ON 

RDYMSG = OFF 

IMPEXEC = ON 
I . MSG . a ON S 

ERRNUM = OFF 

ERRTEXT = ON 

HISTORY = ON 

TODAVAIL = ON 

RTCAVAIL = ON 

IPLASK = ON 

QET = ON 

VERSION = ON 

DATEFORM = 1 

ESCAPE = 27, 1BH, ESC 

UP s 26, 1AH SUB 

DOWN = 10, OAH, LF 

LEFT = 8, 08H, BS 

RIGHT r 6. 06H! ACK 

RUBOUT = 127, 7^, DEL 

CANCEL = 24, 18H, CAN 

SYNONYM s (STD) 

SLICE s 30 I 

PRIVLEV = 5 

SERIAL = 12-34567 

>SHOW MEMORY j 

Port Bank MEMLO MEMMX MEMHI SP PC Size Routine Username { 

0000H A886H 19712 NUCLEUS ! 

1« A580H FDFFH FB21H FAF3H A580H 22656 SHOW SYSTEM 
2 2 4D00H A57FH A2A2H A27AH A2C8H 22656 CSI DEMO 

>SHOW MEMORY 

Port Bank MEMLO MEMMX MEMHI SP PC Size Routine Username 

0000H 4CFFH 19712 NUCLEUS 

4D00H A886H 23431 BASIC 

1 D087H FDFFH FB21H FAF3H D087H 11641 CSI TOM 
2* 4 A887H D086H CDA9H CD87H CDCFH 10240 SHOW PAYROLL 

>SHOW USERS 

Port Username Log-Date Log-Time 
1« SYSTEM 03/31/80 09:23:15 

2 DEMO 03/31/80 10:55:12 

3 PAYROLL 03/31/80 08:30:20 
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SPOOLER COMfAMD 

The SPOOLER command allows you to control the system's print spooler. Not all 
systems that support the OASIS operating system can use the print spooler, only 
those systems that have hardware interrupt capability. An indication of hardware 
interrupt capability is the existence of the time of day clock in OASIS. The 
format of the command is: 

SPOOLER <funetion> 

There are four types of functions that may be specified by the operator. They ares 
start and stop; queue modification; output control; input control. 

SPOOLER Start and Stop Functions 

iNIT This function initializes the spooler for use and must be performed before 
any of the spooler functions can be used with the exception of STATUS and 
LIST. A privilege level of 5 is required to use this function. Before 
this function is used the PRINTER1 device must be attached to the current 
partition. Initializing the spooler causes the spooler to be loaded into 
memory and protected, the printer device driver is 'attached 1 to the 
spooler so that it becomes a public device for all users of a multi user 
system, and a SPOOLER STATUS function is performed. 

When the spooler is initialized it comes up in the following mode: 
STARTED, FORM A, QUEUE A, COPY 1, NOHOLD. 

QUIT This function is only operative when the spooler is inactive (neither 
printing a report nor spooling a file). A privilege level of 5 is 
required to use this function. Performing a SPOOLER QUIT operation causes 
the spooler to be stopped and unloaded from memory. Additionally the 
printer used by the spooler is detached from all users. 

STAR T This restarts the spooler's output functions. A privilege level of 5 is 
required to use this function. 

STATUS The current status of the spooler is displayed by this function. If the 
spooler is not initialized then a message to that effect is displayed. 
When the spooler has been initialized the following information is 
displayed: the current input parameters, the queue(s) that the spooler is 
outputting from, and the current activity of the spooler (printing, 
waiting for work, stopped, etc.). 

STOP This function causes the spooler to stop printing reports after the 
current report is printed. While the spooler is stopped no printing will 
be performed by the spooler except by explicit request (i.e., spooler 
functions ALIGN, PRINT, and RESTART). Stopping the spooler does not allow 
users to use the printer themselves: all reports output to the device that 
the spooler is attached to are still spooled to disk. 

SPOOLER Queue Modification Functions 

CHANGE nn [queue] [copies] [ HOLD j NOHOLD] This function allows you to change the 
printing parameters of a report that has already been spooled. Changing 
any parameter also causes the status of the report to be set to closed. A 
report with closed status is available to the spooler to be scheduled for 
printing when the spooler is outputting from that queue. 

KILL nn Specifies that the spooled report is to be erased from disk and removed 
from the spooler queue. A privilege level of 5 is required to use this 
function. 

L.IST This function lists the reports that have been spooled and are either not 
printed yet or have been printed but have a hold status. The information 
included in this list is the spooled report's file number, account name 
that created the report, date and time of creation, queue, approximate 
number of pages, number of copies to be printed, and the current status of 
report (open, closed, printed, and hold). 

SPOOLER Output Control Functions 

A£ORT Cancel the current report being printed. The current report that is 
actually being printed is aborted, the message "ABORTED" is printed, and 
the number or copies to print is decremented. If the number of copies to 
print is zero the report file is marked as being printed. When the report 
file is not marked with hold status the file will be erased from the 
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spooler* a list of jobs. -.,.■'. 

ALI GN nn This function allows you to perform forms alignment for the specified 
report. The spooler should be stopped before using this function. When 
this function is used the specified report is analyzed by the spooler and 
the first page of the report is printed with every numeric character 
replaced with the digit 9 and all other non-space characters replaced with 
the letter X. After the alignment page is printed the operator is queried 
as to whether or not the alignment pattern should be repeated. The 
operator may respond with a Y or N indicating yes or no. If the response 
is Y then the first page of the report is printed again as described 
above. If the response is N then the report is printed and the spooler is 
stopped. 

BACKUP n The output of the report currently being printed by the spooler is backed 
up the number of pages specified. The backup process always backs up to a 

?age boundary. You may backup up to eight pages at a time. This function 
s useful to reprint a section of the report after a forms jam. 

FORM xxx This specifies the form(s) or queue(s) that the spooler uses for 
scheduling reports to be printed. Only those reports in the specified 
queue(s) will be allowed to be printed by the spooler. Up to eight forms 
may be specified at one time. 

£RINT nn The specified report is scheduled for printing if its queue matches the 
form that the spooler is currently outputting from. After the report is 
printed the spooler is stopped. This function provides for an elementary 
method of prioritizing report printouts. 

RESTART nn nn This function, similar to the PRINT function, allows you to print a 
specific spooled report. The second parameter specifies the page number 
of the report to start the printing on. 

SPOOLER Input Control Functions 

COPIES n This causes subsequent reports created by this user to be printed the 
number of times indicated. You may specify that your reports are printed 
with up to eight copies. 

HOLD This specifies that reports created by this user are to be flagged with 
hold status (after being printed report is not erased from queue). 

HAME xxxxxxxx This function allows you to specify a name for the next report 
spooled to the printer. This name takes the place of your account name 
which is normally used to identify spooled reports. 

NOHO LD This specifies that reports created by this user are to be flagged with no 
hold status (after being printed report is erased from queue). 

.QUEUE x This specifies which queue (A thru Z) reports created by this user are to 
be placed in. 

37*1 Using the Spooler 

Using the OASIS printer spooler is simple for single user operation: make sure the 
PRINTER1 device is attached: make sure that the file SYSTEM. SPOOLQUE exists; 
perform a SPOOLER INIT function. For the requirements of the SYSTEM. SPOOLQUE file 
refer to the appendix "System Files" in this manual. If you always plan to use the 
spooler it is suggested that you incorporate the initialization function in your 
IPL procedure (refer to page 5 of this manual). 

After the spooler has been initialized you will notice that reports are not printed 
as they are output by the user. Instead, the spooler only prints a spooled report 
after the entire report has been 'printed* by the user. 

37*2 Multi User Spooler Operation 

In an OASIS multi user system the start up of the printer spooler is a little more 
complex. If your system has 64K of memory or less follow the single user operation 
described above. For systems with more than one bank of memory you should perform 
the following steps. 

1. Make sure that the PRINTER1 device is attached and the the file SYSTEM. SPOOLQUE 
exists, the same as single user operation. 

2. Load the spooler using the LOAD command (i.e., >LOAD SPOOLER). 
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3. Set your memory partition configuration adding one additional partition of 
approximately 3500 bytes in size. This additional partition is used by the 
spooler and must be the highest numbered partition although it may be in any 
bank of memory. 

4. Initialize the spooler (i.e.. >SP00LER INIT) . This will start up a background 
task in the last partition allocated. 

5. Start up your active users. When any user logs onto the system he will find 
that he has PRINTER 1 device attached and that all of his output to that printer 
is printed on the spooler* s printer. 

37.3 Using Queues 

The OASIS printer spooler uses the concept of multiple queues for reports spooled. 
How you make use of these queues is up to you, however it is intended that they be 
used for two primary purposes : report priortization and forms management . 

Prior tization can be performed by grouping the reports with reports of equal 
priority in the same queue. Use the FORM function to cause the spooler to print 
the reports in the proper sequence. 

Forms management is performed in a similar manner except that reports are grouped 
by form type. When you are ready to print reports on a special form stop the 
spooler, change the forms in the printer, and use the FORM function to cause the 
spooler to print only those reports that correspond to that form type. 

SPOOLER Examples 

>SP00LER INIT 

Spool parameters: Queue=A, Copies=1 , Nohold. 

Spooler has form "A" mounted. 

Spooler is waiting for work. 

>SP00LER LIST 

File# Account Date Time Que Pages Copies Status 

1 SORTREF 12/17/80 14s 16 S TO 1 Printed, hold 

2 DEBUGREF 12/31/80 13?24 S 23 1 Printed, hold 

>SP00LER FORM AS 

>SP00LER PRINT 2 

>SP00LER 

Spool parameters: QueuesA, Copies=1, Nohold. 

Spooler has form n AS n mounted. 

Spooler is printing file 2. 

Multi-user spooler startup examples j 

> ATTACH PRINTER 1 SI02 j 

>L0AD SPOOLER ! 

>SET MEMORY 2 11; SECOND USER PARTITION j 

>SET MEMORY 3 1 2 ; THIRD USER PARTITION j 

>SET MEMORY 4 3500 2 ; SPOOLER PARTITION | 

>SP00LER INIT ! 

Spool parameters: Queues A. Copies=1, Nohold. 

Spooler has form "A" mounted. 

Spooler is waiting for work. j 

>START 2 j 

>START 3 i 

> I 
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START COMHAHD 

The START command is only available on multi-user OASIS. 

The START command activates a user partition. The format of the command is: 

START <pin> [(<indev> [<outdev> [<device option3>]][)]] 

or 

START <coMand> 

Where: 

<pin> Indicates the partition identification number of the user partition to be 
started. This partition must have been previously defined by a SET MEMORY 
command. 

When no parameters are specified after the <pin> then the partition will 
be activated with the console ATTACHed to PORT<pin> and the ATTACH options 
will be the same as the console of the partition performing the START, 
unless other defaults are specified in the SYSTEM. DEVN AMES file. 

<indev> Indicates the physical device name to be used as the CONIN device for the 
user. 

<outdev> Indicates the physical device name to be used as the CONOUT device for the 
user. This specification may be omitted which will indicate that the 
CONOUT device is the same as the CONIN device. 

<device options> Indicates the options to be used on the console device. All of 
the options listed in the ATTACH command description may be used, if 
applicable. 

<command> Indicates that the command is to be performed as a phantom or background 
job. In this situation the START command searches for an allocated but 
inactive partition to be used as a phantom user. When one is found the 
specified command is executed in that parition. The phantom user, when 
started in this manner, only has access to the public disks; no console is 
available. 

When the phantom user is started in this manner the partition will be 
assigned to the phantom user name BK#nn where nn is the number of the 
phantom user (not its partition number). The task specified by <command> 
will be executed and after the task is completed, the parition will become 
inactive again. In order to have the phantom user perform more than one 
task the command that you instruct it to execute should be an EXEC. 

While a phantom user is executing you may monitor its progress by using 
the PEEK command. 

When the START command is executed the user on that partition is asked to logon. 
If the user does not have the console turned on yet he may enter a carriage return 
after turning his console on and the logon message will be re-displayed. 

START Example: 

>SET MEMORY 2 11 

>START 2 (SI02 B96OO L63 P15 FF6 C4 

>SET MEMORY 3 12 

>SET MEMORY 4 13 

>START 4 

>START BASIC TESTPROG 

> 
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STATE COMAED 

The STATE command provides a quick means of determining the existence of a file or 
group of files. The format of the STATE command is: 

5IATE <file-desc> [<option>.,«] 

Where? 

<file-desc> Indicates the description of the file or files to be "stated" . 
Wildcards are acceptable. 

STATE Options 

IYPE Indicates that the number of files found and their total allocation is to 
be displayed on the console. This is the default option. 

UQXTYPE Indicates that nothing is to be displayed. This option is useful when the 
STATE command is executed from an EXEC and it is necessary to know whether 
a file exists or not. A return code of indicates that the file does 
exist and a return code of 12 indicates that the file does not exist. 

BJBLIC Indicates that the public files (owned by the system) are to be included 
in the search. 

When the STATE command is executed one of two messages will be displayed. If no 
file can be found that matches the file-desc the message "No files found" will be 
displayed and the system return code will be set to 12. If one or more files can 
be found that match the file-desc then the message "nn files, nnn blocks" will be 
displayed. The nnn blocks indicates the number of blocks of disk storage used by 
the files qualifying. (Return code set to 0.) 

The STATE command operates only on files accessible to the current account. When 
wildcards are used the public account files will be included in the file count and 
number of blocks of storage used. When the file description is explicit the public 
account files will only be included if a match cannot be found in the private and 
shared files. This means that an explicit file description of a file that is both 
in the private or shared account and also is a file in the public account will 
result in only the private or shared file being reported. 

STATE Examples: 

>STATE * COMMAND S 

42 file(s), 219 block(s). 

>STATE * BACKUP S 
No files found. 
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STOP COMUKD 

The STOP command is only available on multi-user OASIS. 

The STOP command deactivates a user partition. The format of the command is: 

STOP <pin> 

Where: 

<pin> Indicates the partition identification number of the user partition to be 
deactivated. . 

The STOP command can only be used on a partition that has logged off (see LOGOFF 
command) • 

The STOP command does not release the memory used by the partition— the SET MEMORY 
command does that. 
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SISGEH CGMttlD 

The SYSGEN command allows you to save the status of certain system parameters for 
future initial system loads. The format of the command iss 

SLSGEK 

The specific parameters that the SYSGEN command saves include all ATTACHments of 
logical to physical devices along with their options, and the status of the 
following SETable switches: 

ABBREV 

CLKFRQ 

DATEFORM 

ERRNUM 

ERRTEXT 

HISTORY 

IMPEXEC 

PRIVLEV 

RDYMSG 

SLICE 

SYNONYM 

VERSION 



Single user version only 



Multi-user OASIS 
value. 



SYSGEN will save the SLICE value but will not save the PRIVLEV 



In multi-user OASIS the data saved by the SYSGEN command only applies to the 

Partition 1 user; however, some of the data saved is global in nature and therefore 
s saved for all users: CLKFRQ, DATE, ERRNUM, ERRTEXT, HISTORY, SLICE, and TIME. 
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TEXTEDIT COMIAED 

The OASIS TEXTEDIT command allows you to create and maintain files for use by 
programs such as the EXEC language processor, the BASIC compiler/ interpreter, the 
MACRO assembler, the SCRIPT processor, etc. Although the Editor is generally used 
to create or maintain files for these processors there is no restriction on its 
use; you can maintain files to be used by your own programs. 



A file that is created or maintained by the TEXTEDIT program for use by another 
system program generally contains a mixture of commands and data to that program. 
These commands or data should not be confused with the commands that the TEXTEDIT 
program uses. For example, the operator may wish to create a file of commands and 
data to be used by the EXEC processor. All of these commands and data are treated 
as text to the TEXTEDIT program. 

The OASIS TEXTEDIT command is a file editor with commands that allow you to change, 
add or delete text from a file. All of these commands are oriented to the user, 
that is, these commands are English words whose meanings indicate the function that 
they perform in the Editor. For instance, the command that indicates that you wish 
to locate the next occurence of a sequence of characters is "LOCATE 11 . 

All of the commands may be abbreviated to the first character except the FILE and 
QUIT commands which might cause unrecoverable results. 

The OASIS TEXTEDIT is a line oriented editor. This means that after a command is 
executed the text pointer is positioned at the beginning of the current line and 
the commands reference entire lines. For instance the "DELETE" command deletes 
lines of text: the "INPUT" command inputs lines of text; the "PAGE" command types 
lines of text; etc. There is a command available that allows you to use this 
editor as a character oriented editor. This is the MODIFY command. 

Caution: Do not allow a CTRL/Z character to be placed in a file. This character is 
interpreted by most programs as meaning the end-of-file and will probably cause 
loss of data if placed in a file by an operator or user program. 

42.1 Invoking the OASIS TEXTEDITOR 

To enter and use the OASIS text editor you use the CSI TEXTEDIT command in the 
following format: 

TEXTEDIT <f ile-desc> 

When this command is executed the TEXTEDIT program is first loaded into memory and 
the file description is passed to the program. The program then searches the 
directory (specified or default search sequence) and, when the file is found, reads 
the entire file into memory. If the entire file cannot fit into memory due to the 
amount of memory available the Edit program will display the message: "Available 
Memory Now Full:" followed by the last line of text that it was able to read. If 
this line of text is not the last line of text in the file then the operator should 
abort the edit session and reduce the size of the file by manipulating it with the 
COPYFILE command. 

If memory is filled up when the file is read in. and the last line of text is the 
line that is displayed after the error message, the operator may continue the edit 
session if he first deletes some of the text lines before adding any new text. 

When the file is not found on the specified directory or the default search 
directories then the edit program will display the message "New File" before 
displaying the prompt character. 

Due to the fact that the disk image of a file being edited is not updated until the 
operator FILEs the memory image of the file the System Cancel command is redefined 
in the edit session. If this key were not redefined then it is possible that hours 
of work may be lost by the inadvertant typing of this command. To abort an edit 
session the operator uses the QUIT command. 

TEXTEDIT Prompting Character 

After the TEXTEDIT command has been executed an asterisk (*) will be displayed on 
the left side of the console terminal. This is the prompting character for the 
TEXTEDIT program and indicates that the TEXTEDIT program is waiting for a command. 

TEXTEDIT Modes 

The OASIS TEXTEDIT has two modes of operation: the command mode, which is indicated 
by the edit prompting character on the left side of the screen, and the text input 
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mode, which is indicated by no prompting character on the left side of the screen. 

TEXTEDIT Commands, General 

Most of the edit commands have parameters following the command word. These 
parameters tell the edit command interpreter what the operator wishes to do 
specifically. 

Parameters to the edit commands may he of two types? numeric and string. Numeric, 
parameters are always assumed to be decimal (base 10) ; string parameters are always 
enclosed within delimiters. A delimiter is a character that indicates the, 
beginning or end of something. For more versatility the OASIS editor allows many 
characters to be string delimiters. The only restriction being that the delimiting 
character may not be a space character or a question mark character , and the 
delimiter may not be part of the string. The terminating delimiter, when used, 
must be the same as the beginning delimiter. For documentation purposes the slash 
character (/) will be used for the string delimiter. 

If, while typing a line of text or command, the operator should wish to cancel what 
he has entered, he may type either the program cancel-key or the line cancel-key.. 
This will abort the line being typed with no change to the text file. 

42*2 Bottom Command 

The BOTTOM command allows the operator to position the pointer to the end of the 
text. The format of the BOTTOM command is; 

fiOTTCH 

The BOTTOM command will position the pointer to the line before the end of file 
marker, and display the line. If there are no lines of text in the file then the 
BOTTOM command will display TOF: indicating that the line before the end of file 
marker is the top of file marker. 

42«3 Case Co— unci 

The CASE command instructs the editor on whether to •fold* the input from the 
keyboard to uppercase, lowercase or to accept the input as is. 

The format of the CASE command is: 

£&SB [mode] 

Where: 

Mode Meaning 

U 'Fold' or change all alphabetic input from the keyboard to upper 
case. This is the default CASE mode. 

M Accept all input from the keyboard with no translation of case mode. 
This is the default case mode for all non-program file types. 

L Accept all input from the keyboard with inverse translation. This is 
the inverse of the CASE mode M. All alphabetic characters typed from 
the keyboard as text input are translated to their inverse case 
before display. This feature is useful when the console keyboard 
does not have a shift lock key. 

42*4 Tne Carriage Beturn Command 

The carriage return command is provided as a quick and easy means of advancing the 
text pointer to the next line of text in the file. It is identical in effect to 
the DOWN 1 command. The format of the carriage return command is simply to enter a 
carriage return after the edit prompt character. 

42*5 Delete Command 

The DELETE command allows the operator to delete whole lines of text from the file. 
The format of the DELETE command is: 

£gLETE [<nnn>] 

Where: 

<nnn> Indicates the number of lines to be deleted, including the current 
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line. 

<blank> When no parameter is specified after the command DELETE then only the 
current line is deleted. 

42.6 Down Cnaannrt 

The DOWN command allows the operator to position the pointer down to the next line. 
The format of the command is: 

gOHM 

When the DOWN command is executed the next line in the text file becomes the 
current line and is displayed on the console. 

42.7 Down Arrow Coaaand 

The down arrow command provides a quick and easy means of specifying that the text 




pointer one line of text. Some terminals label the down arrow key 
as "line feed" or "LF". 

42.8 File Coaaand 

The FILE command allows the user to terminate an TEXTEDIT session normally by 
updating the file and returning to the CSI. The format of the FILE command is: 

£IL£ [<fUe-desc>] 

Where: 

<file-desc> Indicates an optional file description. When the <file-desc> is 
specified, only as much as is necessary need be entered, the omitted 
parameters will default to the current file description. 

When <file-desc> is specified the current file description is not 
changed but the <file-desc> specified is the description used by the 
FILE command. 

When no <file-desc> is specified after the FILE command the current file 
description is used. In either case when the FILE command is executed the editor 
writes the file in memory to the disk file. If the editor finds an existing file 
on the specified disk with the same name and type as that being filed, the file 
type of that file is renamed to BACKUP, erasing any other file by that same 
description. When the editor has successfully "filed" the text file the file 
description that it was saved as is displayed on the console terminal along with 
the message "filed". Control returns to the CSI. 

42.9 Input Coaaand 

The INPUT command allows the user to add new text to the file. The format of the 
INPUT command is: 

UIPUT 

The INPUT command allows multiple lines of text to be added with each line added 
after the current line. As each line is added it becomes the the current line. 

When the editor is accepting multiple lines of text no prompting character is 
displayed on the left side of the console. This is because the prompting character 
indicates that the editor is ready to accept a command and in this case it is not 
accepting commands but text. 

To return to the edit command mode the user merely types a carriage return with no 
text preceding it. 

42.10 Locate Coaaand 

The LOCATE command allows the user the ability to locate and position to the next 
occurrence of a sequence of characters. The format of the LOCATE command is: 

LOCATE [/<strlng>[/]] 

Where : 
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<string> indicates the sequence of characters that the editor is to search 
for. The search begins with the line following the current line. If 
the sequence of characters is found then the text pointer is 
positioned to the line that contains that string, and tne line is 
displayed. If the sequence of characters is not found then the 
editor displays the message: "Not Found : w followed by the command 
that is was trying to execute. The text pointer is not changed when 
the string is not found, 

<blank> Indicates that the last valid LOCATE command is to be executed again, 

42.11 Modify Comand 

The MODIFY command is the only command that allows the editor to act like a 
character oriented text editor, and when the MODIFY command is being executed there 
is a new set of commands available to the user. The format of the MODIFY command 
is: 

1QDIFI [<nim>|«] 

Where : ^ 

<nnn> Indicates the number of lines that are to be modified. 

* Indicates that all lines starting with the current line to the end of 
the text file are to be modified. To exit from this mode before the 
end of the file is reached you must use the Program Cancel-key. 

<blank> When no parameter is specified then the default value of one is used 
indicating that the current line is to be modified. 

When the MODIFY command is executed the line to be modified is displayed on the 
console terminal and the cursor is positioned at the first character position. The 
editor is now in a character oriented mode and the MODIFY command makes full use of 
the fact that the console terminal is normally a CRT with cursor positioning 
controls. The cursor indicates the current text pointer position in the line. Any 
changes made to the line are immediately indicated by the display of the line and 
the position of the cursor. 

Any control characters imbedded in the line are expanded for display purposes to 
two characters: an up arrow character '(*) followed by the ASCII representation of 
the control character. For example, a CTRL/I is displayed *I. Even though the 
control character is displayed as two characters it actually is only one character. 
When a control character is deleted from the line both characters are erased from 
the display. When a control character is skipped over, both characters are 
skipped, etc. 

The commands available to you when the editor is modifying a line are one character 
commands, but still the one character is the first character of the word that it is 
an abbreviation for. When possible, it is the same character that would be used in 
the edit command mode. 

The following sub-sections discuss the commands available from the MODIFY command. 
When you type a command it is not displayed as that would disrupt the display of 
the line being modified. Any effect that a command has on the text in the line is 
immediatly displayed however. 

Insert Characters Subco— nnd (I) 

To insert new characters into the line the user types the insert command (I). Any 
characters typed after the I has been typed are added to the line before the 
current character. As each character is added to the line the remainder of the 
line is re-displayed. 

To exit from the Insert character command you type a carriage return. 

While in the insert character command you may backup one character position by 

typing the RUBOUT key. This backs the text pointer up one position, the cursor is 

backspaced, and that character is deleted. It is possible to backspace past the 
position that the insert command was given. 

Delete Character Subconand (D) 

To delete a character from the line you use the delete character command (D). 
Every time a D is typed the current character is deleted from the line and the 
character is erased from the screen. This is an immediate command. 
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Replace Characters Subconand (R) 

To replace characters in the line you use the replace character command ( R) . After 
the ft command has been typed each character that is typed replaces the current 
character and the text pointer is advanced one character position. 

To exit from the replace character command you type a carriage return. 

While in the replace character command, you may backup a character position by 
typing the RUBOUT key. This will back the text pointer up one position and the 
cursor will backspace. No characters are deleted and the editor is still in the 
replace character command. It is possible to backspace past the position that the 
replace character command was typed and still remain in the replace character mode. 

Advance Character Subconand ( ) 

To advance the cursor and text pointer one position you type the advance character 

command ( ) , a space. When the space is typed the text pointer and the cursor are 

advanced one character position. You may not advance past the end of the line, 

however you may insert new characters at the end of the line or replace characters 
at the end of the line. 

The right arrow has the same effect as the space key and is more graphic in its 
meaning. Both may be used interchangeably. 

Find Character Subconand (F) 

To advance the cursor and text pointer to the next occurrence of a specific 
character you use the find character command (F) followed by the character to be 
positioned to. When the F is typed followed by another character the cursor is 
advanced to the next occurrence of that character in the line being modified. The 
character specified must be entered in the same case as the character to be found. 
When the character can not be found the cursor will be positioned to the end of the 
line. 

Backspace Character Subconand (RUB) 

To back the text pointer and cursor one character position you type the backspace 
character command. This command is any of the keys defined as the character delete 
keys, such as left-arrow, CTRL/H or RUB. The left arrow is more graphic in its 
meaning and is usually the key that is U3ed for the RUBOUT. When this key is typed 
the text pointer and the cursor are backed up one character position. 

Uppercase Character Subconand (U) 

To change the current character to uppercase you type the uppercase character 

command (U). When the U character is typed the current character is translated 

into uppercase, redisplayed and the text pointer and cursor are advanced one 
character position. 

Lowercase Character Subconand (L) 

To change the current character to lowercase you type the lowercase character 
command (L). When the L is typed the current character is translated to lowercase, 
redisplayed and the text pointer and cursor are advanced one character position. 

Beginning of Line Subconand (B) 

To position the cursor and text pointer to the beginning of the line being modified 
you use the beginning of line command (B) . when the B is typed the cursor is 
positioned to the first character in the line. 

End of Line Subconand (E) 

To advance the cursor and text pointer to the end of the line you type the end end 
of line command (E). When the E is typed the cursor and text pointer are advanced 
to the end of the line. 

This command allows the user to easily add or change text at the end of the line. 

Quit Subconand (Q) 

To quit the modification of the line and restore any changes made to the line you 
type the quit modify command (Q). When the Q is typed the line is re-displayed as 
it was before any changes were made and the modification of the line is terminated. 
If there are any iterations of the MODIFY command remaining then the text pointer 
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advances one line and the next line is placed in the MODIFY mode. 

End Modify Subcoaaand (SET) 

To end the modification of the line and save any changes made to the line you type 
the end modify command ( carriage return) . When the carriage return is typed the 
line is re-displayed with all changes saved and the modification of the line is 
terminated. If there are any iterations of the MODIFY command remaining then the 
text pointer advances one line and the next line is placed in the MODIFY mode. 

42.12 Page Command 

The PAGE command allows the user to display a page of text and to position the text 
pointer to the end of the next page of text. The format of the PAGE command is: 

PAGE 

The PAGE command will display one screen of text* 

The first line of text displayed by the PAGE command is the current line. The last 
line of text displayed on the screen by the PAGE command is determined by the class 
of terminal designated by the OASIS ATTACH command. For the CRT this would be 15 
lines of text. At the end of the execution of the PAGE command the text pointer 
will be positioned to the beginning of the last line displayed. This means that if 
two PAGE commands are typed consecutively then the first line displayed by the 
second PAGE command is the last line displayed by the first PAGE command. In this 
manner it is easy to observe the flow of text in spite of the page break. 

42.13 Quit Coamand 

The QUIT command allows the user to abort an edit session without updating the file 
on the disk. This may be necessary for many reasons such as specifying the wrong 
file in the TEXTEDIT command or the operator has decided that the changes made to 
the file should not be saved. The format of the QUIT command is: 

QUIT [<return code>] 

When the QUIT command is executed with no return code following, the editor will 
set the return code to zero and return control to the environment that invoked the 
TEXTEDIT command (CSI or EXEC) without updating the file. When the return code is 
specified it must be a numeric value between and 255. The value is assigned to 
the system return code and control is returned to the environment that invoked the 
TEXTEDIT command. 

42.14 Top Coasand 

The TOP command allows the operator to position the text pointer to the beginning 
of the text file. It has the inverse effect of the BOTTOM command. The format of 
the TOP command is: 

TOP 

Upon execution of the TOP command the text pointer will be positioned to the top of 
file marker which is before the first line of text. The editor will display the 
message: w TOF: n . This command is the only command that will allow the operator to 
enter lines of text before the first line of text. Refer to the INPUT command. 

42.15 Up Command 

The UP command allows the operator to position the text pointer backward in the 
text file. The effect of the UP command is the reverse of the DOWN command. The 
format of the UP command is: 



UP [<nnn>] 



Where : 



<nnn> Indicates that the editor is to position up nnn lines from the 
current text pointer. If the value of nnn is greater than the number 
of lines that precede the current line then the text pointer will be 
postioned to the top of file marker and the message: n TOF: n will be 
displayed. 

<blank> When no parameter is entered after the UP command then the last UP 
/string/ command is used. If there have been no prior UP /string/ 
commands executed then UP 1 is used. 
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42.16 Up Arrow Conaand 



The up arrow command allows the user a quick and easy means of specifying that the 
text pointer is to back up one line of text. When the operator types the up arrow 
key the editor will interpret it as an UP 1 command, display the message UP 1 , and 
back the text pointer up one line of text. If the console terminal does not have 
an up arrow key then the user may use the CTRL/Z key instead. 



SYSTEM Rev B 



- 95 - 



TEXTEDIT 



SYSTEM BEFEHEMCE MAWUAL 

42.17 TEXTEDIT Co—and Summary 



BOTTOM 

CASE 

DELETE 

DOWN 

FILE 

INPUT 

LOCATE 

MODIFY 



Locate end of file. 

Set upper, lower, or mixed. 

Remove lines of text. 

Advance line pointer. 

Save text file on disk and return to system. 

Accept text from keyboard. 

Locate specified string in text. 

Allow character-by-character chan 

B ** 

D 
E 
F 
I 
L 
Q 
R 
U 
<sp> 



e of current line, 
the line. 



Position to the beginning o 

Delete one character. 

Advance to end of line. 

Find and position to specific character. 

Insert characters. 

Convert to lower case. 

Quit modification - no changes made. 

Replace characters. 

Convert to upper case. 

Advance one character. 



<DEL> Backup one character. 
PAGE Display one screen of text on console. 
QUIT Abort this edit session. 
TOP Locate top of file. 

UP Position line pointer backwards in file. 
<CR> Advance line pointer one line. 
<up-arrow> Position line pointer up one line. 
<down-arrow> Position line pointer down one line. 
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42.18 TEXTEDIT Errors and Messages 

Message Explanation 

Not Sequential Error message - occurs when an attempt is made to TEXTEDIT an 
indexed or direct file. 

Invalid command syntax Error message - occurs during edit command mode. This error 
message indicates that the operator has typed a valid command name but has 
used the wrong parameters or has made a typing error. 

Unrecognized command: Error message - occurs during edit command mode. This error 
is usually caused by the operator typing text when the editor is expecting 
a command. Also occurs when a command abbreviation is used and not 
separated by a space from text that follows it. 

Too many parameters: Error message - occurs during edit command mode. 

Invalid numeric Error message - occurs when the command syntax requires a numeric 
parameter but the operator has entered a alpha character. 

Space required following co— and Error message - 

Required parameter missing: Error message - occurs when the operator has not 
entered all of the parameters required by the command syntax. 

Must be U, L, or M Error message - occurs during CASE command and operator has not 
specified a valid CASE mode. 

Invalid filename Error message - occurs when operator has specified a file 
description. File names must start with an alphabetic character, contain 
only alphbetic, numeric or the $ character and can be no more than eight 
characters in length. 

fn.ftifd filed Information message - displayed after the editor has successfully 
FILED the text file. 

File Name Missing Error message - occurs when operator has specified a file 
description with a missing name field. 

File Type Missing Error message - occurs when the operator has specified a file 
description with a missing type field. 

NEW FILE: Information message - displayed when the TEXTEDIT program is first 
entered and the specified file to be edited is not found. 

EDIT: Information message - occurs when the editor re-enters the edit command 
mode after the INPUT command is exited. 

INPUT: Information message - displayed when the editor enters a multipla Life 
input or replace mode. 

EOF: Information message - displayed when the editor encounters the end of file 
marker. 

TOF: Information message - displayed when the editor encounters the top of file 
marker . 

Not Found: Information message - displayed when the editor can not LOCATE the 
sequence of characters specified. 

No Room: Error message - occurs when the editor detects that there is insufficient 
memory available to save the line of text just entered by the operator. 

End of Memory Reached: Information message - occurs when the editor detects that 
there is probably insufficient memory available to add more lines of text. 

DOWN Information message - displayed in response to the operator typing the 
down arrow in the command mode. 

UP Information message - displayed in response to the operator typing the up 
arrow in the command mode. 
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Available Memory Now Full: Information message - occurs during input of text or 
when TEXTEDIT is loading the file into memory. Indicates that the text 
was accepted and saved in memory but there is not sufficient space 
available for any more text input. 

The operator should delete some text to make space available or divide the 
file into multiple files (if the purpose of the file will allow multiple 
files) . 

Truncated: Error message - the operator has INPUTed. CHANGEd, or MODified a line 
whose new length is greater than 255. The line has been truncated to 255 
characters and is displayed following the error message. 

BACKUP File Is Protected Error message - Indicates that the editor cannot rename 
the input file to BACKUP because a BACKUP file already exists and it is 
delete protected. 

Can't save a BACKUP File Error message - An attempt was made to file or save a file 
with file type BACKUP. 

Disk Full Error message - During an attempt to SAVE or FILE the file being edited 
the disk became full. When this occurs the input file has already been 
renamed to file type BACKUP. Use the CSI command to erase some of the 
unused files on the disk or file it with a differnt name designating that 
a different disk drive is to be used. 
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UNLOAD COMMAND 

The UNLOAD command is only available on multi-user OASIS. 

The UNLOAD command unloads a re-entrant program from memory, freeing up its memory 
space for general usage. The format of the command is: 

UNLO AD <file-desc> 

Where: 

<program-name> Is the name of the re-entrant program to be unloaded from memory. 

The UNLOAD command may only be used in single-user mode (only one partition 
defined) . 

To make the memory used by the re-entrant program available when more than one 

re-entrant program is loaded the programs should be UNLOADed in the reverse 

sequence that they were loaded in; otherwise the memory used by a program may not 
be returned to the system. 
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Com n nil Function 



ACCOUNT Maintain the user account names file. 

ARCHIVE Make archive copy of file, account, or disk volume. 

ASSIGN Assign files or devices to I/O channels. 

ATTACH Make a disk or device available to OASIS. 

BACKUP Copy the entire contents of an OASIS disk to another disk. 

BASIC (Optional) Execute or maintain an OASIS BASIC language program. 

BISYNC (Optional) Emulate IBM 2780/3780 type terminals. 

CHANGE Change the privilege value of a program. 

COPYFILE Copy a file (or portion of a file) to another file (append, replace, 

translate, etc.) 
CREATE Create a new direct or indexed sequential file. 

DEBUG (Optional) Perform dynamic debugging of a machine language program. 
DUMPDISK (Optional) Display the physical contents of a disk file. 
EDIT (Optional) Create or modify an ASCII sequential file. 
ERASE Delete a file or files from a disk. 
EXEC Execute an EXECutive language program. 
FILELIST Display the files and their attributes on the terminal, printer, or to a 

disk file. 
FILT8080 (Optional) Translate Intel mnemonic assembly language source program to 

Zilog mnemonic assembly language source program. 
FORCE Force another user to execute a command. 
GETFILE (Optional) Copy a file from a non-OASIS disk. 
INITDISK Initialize a disk format, directory, or label. 
INITTAPE (Optional) Initialize a tape format or label. 
INTELHEX (Optional) Convert INTEL hex object code to OASIS object code. 
KILL Erase a file without de-allocating the space. 
LINK (Optional) Perform translation and editing of object programs to load 

image programs. 
LIST Display the contents of a file on the terminal or printer. 
LOAD Load a re-entrant program for subsequent usage. 
LOGOFF Sign off of the current user account. 
LOGON Sign on to a different user account. 
MACRO (Optional) Translate a Zilog mnemonic assembly language source program to 

an object program (assemble). 
MAILBOX Retrieve information from other users. 
MEMTEST (Optional) Perform diagnosis of memory. 
MOUNT Allow a change of disks. 
MSG Send a message to another user. 

OWNERCHG Change the ownership of a file to another account. 
PATCH Update disk image of assembled program file. 
PEEK Peek at another user's console output. 
RECEIVE (Optional) Accept a file from another OASIS system. 
RECOVER (Optional) Restore lost file to it's directory. 
RELOCATE (Optional) Create a relocatable command from an absolute command. 
RENAME Change the name or type of an existing file. 
REPAIR (Optional) Detect and correct disk mis-allocation. 
RESTORE Retrieve archived copy of file, account, or disk. 
RUN (Optional) Execute an OASIS BASIC compiled program. 
SCRIPT (Optional) Process and output an OASIS SCRIPT language file. 
SECTOR (Optional) Display sector linkages of a sequential file. 
SEND (Optional) Transmit a file to another OASIS system. 
SET Change OASIS system parameters. 

SHARE Designate a file(s) to be accessible from other user accounts. 
SHOW Display OASIS system parameters. 
SORT (Optional) Sort a file by specified keys. 
SPOOLER Change or display status of the printer spooler. 
START Start another user partition. 
STATE Determine existence of a file(s). 
STOP Stop another user partition. 
SYSGEN Permanently save SET and ATTACH status. 
TERMINAL (Optional) Emulate terminal to foreign system. 
TEXTEDIT Create or modify a text file. 
UNLOAD Unload a previously loaded re-entrant command. 
VERIFY (Optional) Read an entire disk and report any errors detected. 
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DEVICE NDMBEB ASSIGNMENTS 

The following numbers, names, and synonyms are the only logical device designations 
that the ATTACH command recognizes. All programs and commands communicate with 
peripherals by means of these logical device designations. The actual device that 
these are associated with is normally unknown (and irrelevant) at execution time. 
Adding additional physical device drivers to a system does not increase the number 
of logical devices in the system. 

Logical Device Numbers 



Internal External 

Number Number Device-Name Synonym 



9 
10 
11 
12 

}l 
It 
\l 

19 
20 
21 
22 
23 



9 
10 
11 
12 

j? 

\\ 

19 
20 
21 
22 
2 



DUMMY 

DISK-S 

DISK-A 

DISK-B 

DISK-C 

DISK-D 

DISK-E 

DISK-F 

DISK-G 

CONIN 

CONOUT 

READER 

PUNCH 

PRINTER 1 

PRINTER2 

PRINTER3 

PRINTERS 

C0MM1 

C0MM2 

C0MM3 

C0MM4 

TAPE1 

TAPE2 

TAPE3 

TAPE4 



S 

A 

B 

C 

D 

E 

F 

G 

CONI 

CONO 

RDR 

PUN 

PRINTER, PRT, PRT1 

PRT2 

PRT3 

PRT4 

COMM, COM, C0M1 

COM2 

COM3 

COM4 

TAPE, TAP, TAP1 

TAP2 

TAP- 

TAPl 



* The devices 
CONSOLE. 



CONIN and CONOUT may be treated as a single device by using the name 
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INDEXED FILES 

As explained in the description of the CREATE command indexed files require a 
filesize that is dependant upon an algorithm used in accessing the file. The 
filesize entered in the CREATE command may be modified by the system in order to 
optimize access to that file. Table D-1 is a partial list of the filesizes used by 
the system for indexed file access. It is provided here to inform the programmer 
of the filesize that was used in creating an indexed file. Using this information 
the programmer can calculate the amount of disk space required by the file without 
actually creating it. 

Indexed file access response time is relatively constant until the file is 
approximately 70-80$ full. When a file exceeds this load factor the response time 
degrades to unacceptable times. For this reason indexed files should be 
over-allocated to insure that the response time will not degrade. 

It should be noted that, although the average response time degrades as the file 
fills, the response time for a particular record remains constant. For this 
reason, records that will be accessed more frequently than others should be added 
to the file when the file is nearly empty. 

C.1 Indexed File Access 

An indexed file is organized in two contiquous regions. The first region contains 
the record numbers of the records in the logical collating sequence. The second 
region contains the keys and records along with a forward pointer to the next 
record in the collating sequence. 

When a record is added to an indexed file the key is hashed to a record location in 
the file. If the location is empty the key and record is written to that location. 
The file is then searched using a binary search of the first region (index area) 
looking for the record that logically precedes this record by one. After that 
record is found its forward pointer is updated to point to the record being added 
and its previous forward pointer is transferred to the record being added. After 
this is done the index area is updated with the new record number placed in its 
proper position. 

To access an indexed record randomly the key being looked for is hashed to a record 
location in the file. The location is read and its key is compared with the key 
desired. If the two keys are equal the record is returned to the program 
requesting it. If the two keys are different then the key is rehased to another 
location and the comparison is done again. This procedure continues until the 
desired key is found or an empty record is found. In the latter case the program 
requesting the record is informed that the record does not exist. 

To access an indexed record sequentially the forward pointer from the most previous 
access to the file is used to read the next record in the file. If no there were 
no previous accesses to the file then the first entry in the index area is used to 
point to the logically first record in the file. 
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TABLE D-1 
Indexed File Format Filesizes 

103 107 127 131 139 151 163 167 179 191 199 211 223 

227 239 251 263 271 283 307 311 331 347 359 367 379 

383 419 431 439 443 463 467 479 487 491 499 503 523 

547 563 571 587 599 607 619 631 643 647 659 683 691 

719 727 739 743 751 787 811 823 827 839 859 863 883 

887 907 911 919 947 967 971 983 991 1019 1031 1039 1051 

1063 1087 1091 1103 1123 1151 1163 1171 1187 1223 1231 1259 1279 

1283 1291 13Q3 1307 1319 1327 1367 1399 1423 1427 1439 1447 1451 

14|9 1471 1483 1487 1499 1511 1523 1531 1543 1559 1567 1571 1579 

1583 1607 1619 1627 1663 1667 1699 1723 1747 1759 1783 1787 1811 

1823 1831 1847 1867 1871 1879 1907 1931 1951 1979 1987 1999 2003 

2011 2027 2039 2063 2083 2087 2099 2111 2131 2143 2179 2203 2207 

2239 2243 2251 2267 2287 2311 2339 2347 2351 2371 2383 2399 2411 

2423 2447 2459 2467 2503 2531 2539 2543 2551 2579 2591 2647 2659 

2663 2671 2683 2687 2699 2707 2711 2719 2731 2767 2791 2803 2819 

2843 2851 2879 2887 2903 2927 2939 2963 2971 2999 3011 3019 3023 

3067 3079 3083 3119 3163 3167 3187 3191 3203 3251 3259 3271 3299 

3|Q7 3319 3323 3331 3343 3347 3359 3371 3391 3407 3463 3467 3491 

38 f 



3671 3691 3719 3727 3739 3767 3779 3803 3823 3847 3851 3863 3907 

1911 3919 3923 3931 3943 3947 3967 4003 4007 4019 4027 4051 407< 

1091 4099 4111 4127 4139 4159 4211 4219 4231 4243 4259 4271 428; 



4327 4339 4363 4391 4423 4447 4451 4463 4483 4507 4519 4523 4547 

4567 4583 4591 4603 4639 4643 4651 4663 4679 4691 4703 4723 4751 

4759 4783 4787 4799 4831 4871 4903 4919 4931 4943 4951 4967 4987 

4999 5003 5011 5023 5039 5051 5059 5087 5099 5107 5119 5147 5167 

5171 5179 5227 5231 5279 5303 5323 5347 5351 5387 5399 5407 5419 

5431 5443 5471 5479 5483 5503 5507 5519 5527 5531 5563 5591 5623 

5639 5647 5651 5659 5683 5711 5743 5779 5783 5791 5807 5827 5839 

5843 5851 5867 5879 5903 5923 5927 5939 5987 6007 6011 6043 6047 

6067 6079 6091 §131 6143 6151 6163 6199 6203 6211 6247 6263 6271 

6287 6299 §31 1 §323 6343 6359 6367 6379 6427 6451 64Q1 6547 6551 

6563 6571 6599 6607 6619 6659 6679 6691 6703 6719 6763 6779 6791 

6803 6823 6827 6863 6871 6883 6899 6907 6911 6947 6959 6967 6971 

6983 6991 7019 7027 7039 7043 7079 7103 7127 7151 7159 7187 7207 

7211 7219 7243 7247 7283 7307 7331 7351 7411 7451 7459 7487 7499 

7507 7523 7547 7559 7583 7591 7603 7607 7639 7643 7687 7691 7699 

7703 7723 7727 7759 7823 7867 7879 7883 7907 7919 7927 7951 7963 

8011 8039 8059 8087 8111 8123 8147 8167 8171 8179 8191 8219 8231 

8243 8263 8287 8291 8311 8363 8387 8419 8423 8431 8443 8447 8467 

8527 8539 8543 8563 8599 8623 8627 8647 8663 8699 8707 8719 8731 

8747 8779 8783 8803 8807 8819 8831 8839 8863 8867 8887 8923 8951 

8963 8971 8999 9007 9011 9043 9059 9067 9091 9103 9127 9151 9187 

9199 9203 9227 9239 9283 9311 9319 9323 9343 9371 9391 9403 9419 

9431 9439 9463 9467 9479 9491 9511 9539 9547 9551 9587 9619 9623 
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MEMORY/DISK LAIOOT 



low 



high 




Re-entrant 
loaded 
programs j 
A A /\ / 
\/ V V 

A A A / ! 
V \/ \/ 



SCR 3 



USER 3 



Dev drivers 



SCR 2 
USER 2 



Dev drivers 

"~~sciT~T 



USER 1 
Dev drivers 



User 3 device drivers 
System Communication Region 

User 2 program area 



User 2 



User 2 device drivers 

System Communication Region - User 1 

User 1 program area 

User 1 device drivers 
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SCR 

low ! Attach table i 
Assign table 
SET switches 
Partition 

memory 

configuration 
Logon data 
Synonym name 
Tabsets 
etc. 

!/\ /\ /\ A . 

V V V \/ 

A A A A / 

V V V \/ r 
WORK 

PCR 

high J Command string 



256 byte work area 

256 byte communication area 



Sector 



OASIS Disk Layout 



Contents 





1 

2 thru j 

j+1 thru 

k+1 thru 



Boot loader. 

Disk label and allocation bit map. 

Any additional sectors needed for bit map. 

Directory entries (8 entries per sector). 

1K blocks for files and programs. 



i = surfaces * (tracks/surface) * (sec tors/ track) 

j = ((i/4)-1792)/2048 

k s directory size * 8 - j 
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E.1 The System Disk 



The OASIS system requires a system disk to operate. The system disk is always the 
disk currently attached as the n S n disk and normally is the disk the system was 
booted from. 

Frequently the system disk contains all of the commands to be used by the operator. 
However, this is not a requirement. In order for a disk to qualify as a system 
disk it must contain, as a minimum, the following files: 



SYSTEM. 
SYSTEM. 
SYSTEM. 
SYSTEM. 
SYSTEM. 
SYSTEM. 
SYSTEM. 
SYSTEM. 
SYSTEM. 
SYSTEM. 



NUCLEUS 

CSI 

EXECLANG 

EXEC1 

DEVNAMES 

ERRMSG 

DEVnn 

CLASSnn 

ACCOUNT 

HISTORY 



If EXEC programs are to be executed. 
If EXEC programs are to be executed. 

Device drivers (only those used) 
Terminal class codes (only those used) 
If accounting is implemented 
If accounting is implemented 



As can be seen, the required files all have the file name SYSTEM. For the best 
response time of the system these files should be placed on the disk near the 
beginning. (Some systems require that the SYSTEM. NUCLEUS immediately follow the 
directory.) Accomplishing this is relatively simple: onto a cleared disk (INITDISK 
command) copy the SYSTEM. NUCLEUS, then copy all other SYSTEM files (COPYFILE SYSTEM 
* S = = <fd>). 

Because the SYSTEM. ACCOUNT file resides on the system disk, changing system disks 
may cause a different set of account names to be available. For this reason it is 
generally best to have only one system disk with different data disks for the 
various applications of the computer. Sometimes this is not possible. In this 
situation, changes to the SYSTEM. ACCOUNT file on one system disk should be made to 
all system disks by using the COPY option of the ACCOUNT command. If this is not 
done, operators may become frustrated when they cannot LOGON to their account, 
thinking that somebody has restricted their access to the system when in fact 
somebody merely used a different system disk. 

NOTE: The system disk received from your OASIS distributor should be kept "virgin": 
make no changes to account names, privilege levels, etc., without considering the 
effect this might have on the access and support of the operating system. The user 
should always be able to return to the version of the system received to determine 
if a problem is in the original system or in something he may have done to the 
system. 

Multiple System Disks 

When it is necessary to have multiple system disks you should make the 
SYSTEM. ACCOUNT file identical on all system disks. This is easily done by using 
the COPY option of the ACCOUNT command. 

The importance of maintaining identical SYSTEM. ACCOUNT files on the various system 
disks cannot be overemphasized. If account ids are different on a system disk then 
the accounts will have a different set of files. It is possible that a set of 
files will be unaccessible (and their existence will not be reported) if accounts 
are irresponsibly deleted or changed. 

E.2 The SYSTEH.DEVNAMES File 

The SYSTEM. DEVNAMES file contains the acceptable names of all physical devices, 
their primary modes of operation, and any default options to be used. This is a 
sequential file and is maintainable by the user. In fact, additional names can be 
added to this file to create more meaningful synonyms to existing devices. If a 
device name is not in this file you will not be able to ATTACH a logical name to 
the device (except by using the physical device number, i.e. ATTACH A 4) . 

The format of the file is simple and straightforward: one record per device name, 
each record containing the device name, device number, mode of operation, and any 
default options, all separated by a single space. 

The device name is any alphanumeric string of characters, up to eight characters in 
length, with the same limitations as file names (no embedded spaces, must start 
with a letter, etc.). This name will be the normal method of specifying the device 
in the ATTACH command. 
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The device number is the number of the device driver program to be used to service 
the device. When a device is ATTACHed this number is used to find the device 
driver program on the system disk. All device driver programs have file 
descriptions in the form: SYSTEM. DEVnn where nn is the number of the device driver. 
This number must be in the range 1 through 32 and the numbers 1 through 8 are 
reserved for disk device drivers. Care should be taken to ensure that two or more 
device drivers are not attached that service the same peripheral. This would cause 
unpredictable results. 

The mode of operation may be any combination of the following : 

D - Indicates the device is a disk device. 

C - Indicates that the device may be a console. 

P - Indicates that the device is a printer. 

S - Indicates that the device uses serial I/O. 

I - Indicates that the device supports input. 

— Indicates that the device supports output. 

These codes tell the ATTACH command what options may apply to the device. For 
example a device that uses serial I/O uses the options: PO, PE, B, LF, FF, ENAB; 
printer devices use the options: L, P, 0, PP. 

The default options are the same as the ATTACH command uses. For example, the 
default options for a baud of 1200, enable 3 handshaking, line length of 96, and 
page length of 60 would be: B1200 E3 L96 P60. 

It is permissible for more than one device name to have the same device number. 
These additional device names will be treated as synonyms to the first device name 
that uses the number. 

Disk device name records in this file contain additional information: the disk 
devices that share the disk driver. Normally a disk controller and the disk driver 
program control and communicate with up to four disk drives. To indicate to the 
ATTACH program that only one disk driver need be loaded for all of the disks that 
share this driver the ATTACH program needs to know exactly which disks are shared 
by the driver. 

To illustrate this file part of the standard, distributed file will be used. The 
complete DEVNAMES file varies from system to system. 

FL0PPY1 1 D 1 2 3 4 
FL0PPY2 2 D 1 2 3 4 
FL0PPY3 3 D 1 2 3 4 
FL0PPY4 4 D 1 2 3 4 
PI01 13 PIO 
LP 13 PIO 
SI01 17 CPSIO 
SIO 17 CPSIO 
DISK1 1 D 1 2 3 4 
DISK2 2 D 1 2 3 4 
DISK3 3 D 1 2 3 4 
DISK4 4 D 1 2 3 4 

As can be seen there are four disk devices: FLOPPY 1, FL0PPY2, FLOPPY^, and FL0PPY4. 
These four devices have synonyms of DISK1, DISK2, DISK3. and DISK4 respectively. 
(Only the FLOPPYn names will be used when the current attachments are displayed as 
they occur first in the file.) Additionally, these four disk devices all share one 
disk driver. 

There is a serial device named SI01 with a synonym of SIO. This serial device 
supports input and output and may be attached as the console. 

There is also a parallel device named PIO with a synonym of LP. This parallel 
device supports input and output. 

E.3 The SYSTEM. DEVnn Files 

The files are the physical device driver programs and should be kept unless disk 
space is at a premium on the system disk and one or more device drivers are never 
used. 

E.4 The SYSTEM. CLASSnn Files 

These files are the terminal class code translation tables used by the C0N0UT 
device to translate cursor control commands into the proper codes required by your 
specific terminal. It is only necessary to keep the specific class code files that 
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you use — the others may be deleted to make more space available on your system 
disk. 

For more information about these files refer to the appendix on "Terminal Class 
Codes" in this manual. 

E.5 The SYSTEM.ERBMSG File 

The SYSTEM. ERRMSG file contains all of the error, warning, and information messages 
that the system uses. This file is a direct file and cannot be maintained by the 
editor. However, a program is available to maintain this file if it is necessary 
to translate the messages to a foreign language. 

The format of this file is simple: one record per message, each record containing 
the message number and the message text, separated by one space. 

The message number is a number in the range of 1 through 255 used by the system to 
reference the messages. 

The message text contains the message itself. Some messages contain variable 
information determined only at display time. This variable information is denoted 
by inclosing the parameter number within braces such as {1}. 

E.6 The SYSTEM. ACCOUNT File 

The SYSTEM. ACCOUNT file is a restricted access file required by the system if user 
accounting is to be used. Once this file has been removed (only by using the 
ACCOUNT command) from a disk there can be no user accounting while that disk is the 
system disk. 

This file contains information about the user accounts: the account names, 

Passwords , and privilege levels for each account in the system. This file can only 
e accessed by certain system programs and can only be maintained by the ACCOUNT 
command when the system account is logged on. 

E.7 The ACCOUHT. HISTORY File 

The ACCOUNT. HISTORY file contains the user accounting information that was 
transferred from the SYSTEM. HISTORY file (see ACCOUNT command). This file is a 
sequential file accessible by the user for logon analysis, etc. A record is added 
to the SYSTEM. HISTORY file (and later transferred to the ACCOUNT. HISTORY file) 
every time a user logs on, logs off, or boots the system. 

Each record of this file contains information dependent upon what caused it to be 
created. However, every record begins with the same format: time of creation, date 
of creation, and record type. The record type information specifies what caused 
the record to be created and what information follows: 

1 System boot - no further data 

2 User LOGON - followed by account name, id, and port. 

3 User LOGOFF - followed by account name, id, port, 

and elapsed logon time in minutes. 

All fields of information are separated from other fields by spaces. The date 
field is in standard date format: mm/dd/yy. The time field is in standard time 
format: hh:mm:ss. Account names always use eight positions with trailing spaces, 
if necessary. The elapsed time may have leading spaces (no leading zeros) and is 
expressed to the nearest hundredth of a minute. 

Because the ACCOUNT. HISTORY file is always replaced (not appended to) when the 
SYSTEM. HISTORY information is transferred you should probably append the file to 
one of your own if you wish to maintain any archive information. 

Note 1 : If your system does not support the time of day feature the time of 
creation and the elapsed time fields will contain zeros. By placing zeros in the 
record the file will have the same format as a file created on a system that does 
have the time of day feature and can be analyzed by a program that is identical on 
both systems. 

Note 2: The history record creation can be turned on or off with the SET command. 

E.8 User Defined Synonyms File 

The user defined synonym file, referred to in the SET and SHOW commands, is a 
sequential file(s) created and maintained by the user containing the user defined 
synonyms to commands. There may be more than one user defined synonym file in the 
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system but the SET command only allows one of the files to be designated as the 
user synonym file at any one time. 

This file may have any valid name but must reside on the system disk and must have 
a file type of SYNONYM. This option of the system is not normally used but is 
quite convenient in some situations. The most frequent use of this option occurs 
when a user has access to, and utilizes, several different operating systems. In 
order to avoid confusion this user would probably create a synonym file that 
reflects the command names used by the other system(s). (The other system probably 
doesn*t allow the user to define his own synonyms.) For example, some operating 
systems use the name DIRECTRY, DIR or VTOC for the function performed by OASIS 's 
FILELIST command. In this case the user could create a synonym (using the TEXTEDIT 
or EDIT programs) for the FILELIST command of DIRECTRY with an acceptable 
abbreviation of three characters (DIR). Other commands could be treated similarly. 

The format of the user defined synonyms file is relatively simples one record per 
synonym definition, each record containing three fields specifying the true command 
name, the synonym to the command name, and the minimum number of characters allowed 
for abbreviation of the synonym, each separated by a single space from the other 
fields. The minimum number of characters allowed for abbreviation is optional and, 
when omitted, implies that no abbreviation is allowed. 

In the above situation the synonym for the FILELIST command would look like: 

FILELIST DIRECTRY 3 
FILELIST VTOC 

E.9 The SYSTEM. EXECnn Files 

The SYSTEM. EXEC1 file is a data file used by the EXECutive language processor to 
save the status and variables of one or more EXEC programs while another EXEC 
program or command is executing. 

In multi-user OASIS there will be more than one of these files, i.e., EXEC1 , EXEC2, 
etc. , one for each user partition. 

This file is a direct access file with each record 512 characters in length. The 
number of records in this file determine the level of EXEC call nesting allowed b 
the system. As distributed this file contains two records which allow one EXE 
program to call another but does not allow that second program to call another EXEC 
program. 

To expand (or decrease) the level of EXEC nesting log on to the system account, 
erase the SYSTEM. EXECnn files (be conscious of the fact that while this file is 
removed no EXECs may be executed and the system may not be booted) , and create a 
new file with the filesize corresponding to the level of nesting desired. 

E.10 The SYSTEH.SPOOLQUE File 

The SYSTEM. SPOOLQUE file is a data file used by the printer spooler and must be 
created by the user before the spooler is invoked (see chapter: "SPOOLER COMMAND"). 
This file may reside on any attached disk although it should be put on the disk 
with the most space available as the reports spooled to disk by the printer spooler 
will be put on the same disk as this file. The file format is direct and the 
record length is 16 bytes. The number of records allocated determines the number 
of files that may be waiting for the spooler to print. 

A usable file size for the SYSTEM. SPOOLQUE file is about 64 records. This size of 
a file can be created by entering the command: 

>CREATE SYSTEM SPOOLQUE S (DIRECT RECLEN 16 FILESIZE 64) 
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ANSI FORMS COMTROL 

The OASIS Operating System utilizes the American National Standards Institute 
(ANSI) standard for printer forms control for output directly to a device attached 
as a printer. 

When ANSI forms control is used (optional in the LIST command) the first character 
of each record transmitted to a printer is a forms control command. This command 
character is not printed on the printer but is translated to the codes required to 
effect the forms control desired. A record is always terminated with a carriage 
return (in BASIC this is accomplished by using no trailing semicolon in the output 
list). 

Every record output to a printer is printed with a trailing carriage return but no 
trailing line feed. The line advance is performed by the next record's forms 
control, if desired. 

The following is a list of the control characters and their functions. 

Char Function 

1 Forms eject. 

+ No forms advance. This allows for overprinting. 

Double line advance. Creates one blank line. 

Triple line advance. Creates two blank lines, 
other Single line advance. This is the normal mode of printing and is 

equivalent to printing without ANSI forms control except the first 

character is not printed. 
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The terminal class code, set with the ATTACH command, informs the operating system 
what display features a console has and how to invoke them. Unfortunately terminal 
manufacturers have no standards imposed on them in this area. Therefore each 
manufacturer uses the method that he thinks is best or is easiest for the company 
to implement. 

In most systems, programs that try to utilize some of the special features that 
terminals have must be coded for the specific terminal(s). This is not necessary 
when using the OASIS system. In OASIS programs are coded using an internal set of 
codes defined below. When outputing to the console OASIS translates these codes to 
the codes required by the attached console. This provides greater flexibility and 
transportability for the programs. 

6.1 Implementing New Class Codes 

If you have a terminal that you wish to use as a console but its cursor control 
requirements are not met by any of the class codes defined and distributed then you 
may implement your own class code by using the OASIS MACRO assembler. 

For details on the requirements of the SYSTEM. CLASSnn file refer to the OASIS MACRO 
Assembler Language Reference Manual . 

6.2 Terminal Class Code Tables 

The tables on the following pages describe the classes implemented and distributed 
with the OASIS operating system. Each class code is defined in its respective 
SYSTEM. CLASSnn file. 

Due to the delay between implementing a new class code and the distribution of the 
documentation there may be more class codes implemented than are listed in the 
tables. Contact your distributor to determine if any new class codes have been 
implemented. 

Internal Terminal Codes 



! Function 



Code 



Val j Function 



Val 



HOME 

CLEAR 

EOS 

EOL 

LEFT 

RIGHT 

UP 

DOWN 



ULON 
ULOFF 
RVON 
I RVOFF 



Cursor HOME 
Clear Screen 
End Of Screen clear 
End Of Line clear 
Curosr Left 
Cursor Right 
Cursor Up 
Cursor Down 
Cursor address 
Address coding 
Underline ON 
Underline OFF 
Reverse Video ON 
Reverse Video OFF 



SOH 


1 


FF 


12 


CAN 


24 


ETB 


2 3 


BS 


8 


ACK 


6 


SUB 


26 


LF 


10 


DLE,c,l 


16 


Abs 




VT 


11 


SYN 


22 


SO 


14 


SI 


15 



KON Keyboard ON 

KOFF Keyboard OFF 

PON Protect ON 

POFF Protect OFF 

BON Highlight on 

BOFF Highlight off 

EU Erase unprotected 

IL Insert Line 

IC Insert Character 

DL Delete Line 

DC Delete Character 

FON Format ON 

FOFF Format OFF 



EM 

NAK 

EOT 

ENQ 

GS 

RS 

FS 

DC1 

DC3 

DC2 

DC4 

STX 

ETX 



25 

2 l 

5 
29 

39 
28 

17 

20 
2 
3 
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In the following tables abbreviations are used which are defined as: 

N/A Indicates that the function is not available on the terminal. 

Simulated Indicates that the function is not available on the terminal but is 
simulated by the operating system. For example, EOS is simulated by 
outputting spaces to the end of the screen and then re- positioning to the 
same screen location. 

Standard Indicates that the line and column number is coded using the ASCII 
displayable character sequence. Value 1 = space, value 2 = "!", etc. 

Special Indicates that the bias for the line number is different than for the 
column number. 

Abs Indicates that the line and column number is coded using the absolute 
values for the line and column number, base zero. Value 1 is a binary 0, 
value 2 is a binary 1, etc. 

ASCII Indicates that the line and column number is coded using the ASCII 
character representation of the value. Value 1 is n 1 n , value 2 is "2", 
value 15 is "15", etc. 

Some class code files perform input translation as well as output translation. 
When this is the case the table following the class code table defines the 
character values (in hexadecimal) translated. This input translation facilitates a 
consistent interface for arrow keys, etc. 
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Terminal Class Codes 1.-4 




| FILE 
Func 

Jhohe 

j CLEAR 

!eos 

EOL 
LEFT 
RIGHT 
UP 
JDOWN. 

j Jk § X 

Bias 

!lL 

IC 

DL 

DC 

EU 

KON 

KOFF 

PON 

POFF 

FON 

FOFF 

BON 

BOFF 

ULON 

ULOFF 

RVON 
SRVOFF 


CLASS1 , 
BEEHIVE 100 

ESC . H 
ESC.X, 

ESC,E 
ESC, J 
ESC,K 
ESC,D 
ESC,C 
ESC, A 
LF 

ESC,F,l,c 
Standard 

n/a"" 

N/A 

N/A 

N/A 
ESC,E 
Simulated 
Simulated 
ESC,] 
ESC [ 
ESC,W 
ESC,X 
ESC,1 
ESC.m 

N/A 

N/A 

N/A 

N/A 


CLASS2 
ADDS 580 
Envoy j 

DLE,0,VT,» "' 
FF 

Simulated 
Simulated 
NAK 
ACK 
SUB 
LF 

DLE,l,VT,c 
Standard 

" N/A 

N/A 

N/A 

N/A 

N/A 
Simulated 
Simulated 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 


CLASS3 ! CLASS4 
ADM 3A j SOROC IQ 

RS j RS 
SUB j ESC,* 

Simulated | ESC,Y 
Simulated ESC,T 
BS BS 
FF FF 
VT VT 
LF LF 
ESC,s,l,c ESC,=,l,c 
Standard | Standard 

N/A N/A 
N/A N/A 
N/A N/A 
N/A ESC,+ 
Simulated Simulated 
Simulated Simulated 
N/A ESC,) 
N/A ESC,( 
N/A ESC,& 
N/A ESC,» 
N/A N/A 
N/A N/A 
N/A N/A 
N/A N/A 
N/A N/A 
N/A ! N/A 



Input Translation 



From 



To 



From 



To 



From 



To 



From 

'Sbh~" 

OCH 
1EH 



To 

"Tah" 

06 H 
01H 
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Terminal Class Codes 5-8 



| FILE ! CLASS5 
V D M 
|Func I 


CLASS6 
HAZEL TINE 
1400/1500 


CLASS7 i 
TELEVIDEO 
912/920 


CLASS8 ! 
Perkin- Elmer j 
Fox 


'.HOME 
CLEAR 
EOS 
EOL 
LEFT 
RIGHT 
UP 
DOWN 

|x,y 

Bias 


SOH 

FF 

CAN 

ETB 

BS 

ACK 

SUB 

LF 

DLE,c,l 

Abs 


~,DC2 

~,FS 

-,CAN 

DLE 

~,DC1,C,1 
Special 


RS 

ESC,* 

ESC,Y 

ESC,T 

BS 

FF 

VT 

LF 

ESC,=,l,c 

Standard 


ESC,H ! 

ESC,K 

ESC, J 

ESC, I 

ESC,D 

ESC,C 

ESC A 

LF 

ESC,X,1, 

esc'y;c 

Standard 


!lL 
IC 
DL 
DC 
EU 
KON 
KOFF 
PON 
POFF 
FON 
FOFF 
BON 
BOFF 
ULON 
ULOFF 
RVON 
IRVOFF 


DC1 

DC3 . 

DC2 

DC4 

FS 

Simulated 

Simulated 

EOT 

ENQ 

STX 

ETX 

GS 

RS 

VT 

SYN 

SO 

SI 


~,SUB 
N/A 

~,DC3 
N/A 

~.GS 

Simulated 

Simulated 

~,EM 

~,us 

N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 


ESC,E 
ESC,Q 
ESC,R 
ESC,W 
N/A 
Simulated 
Simulated 
ESC,& 
ESC,' 
ESC,) 
ESC,( 
ESC, X 
ESC.q 
ESC, I 
ESC,m 
ESC,j 
ESC,k 


N/A ! 

N/A 

N/A 

N/A 

N/A 
Simulated 
Simulated 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A j 



Input Translation 



i j From 


To 


From 


To 


From 


To 


From 


To | 


i i 








OBH 


1AH 














OCH 


06 H 






i i 








1EH 


01H 
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FILE 
Func 

home""" 

CLEAR 

EOS 

EOL 

LEFT 

RIGHT 

UP 

DOWN 

Bias 

IE""""" 

IC 

DL 

DC 

EU 

KON 
KOFF 
PON 
POFF 
FON 
FOFF 
BON 
BOFF 
ULON 
ULOFF 
RVON 
IRVOFF 



Terminal Class Codes 9-12 



CLASSQ ! 
erkin-Elmer ' 


CLASS10 


CLASS 11 


CLASS12 


ANSI 


Infoton 100 


V G 


Bantom 


Heath H19 




Flashwriter 


ESC>H 


""esc7£h " 

ESC.LH, 


""escTh 


"soh" """ 


ESC,K 


FF 


FF 




ESC,[2J 






Simulated ■ 


ESC, 


,J 


ESC, J 


CAN 


Simulated ' 


ESC, 


K 


ESC,K 


ETB 


ESC,D 


ESC, 


.D 


BS 


BS 


ESC.C 


ESC, 


.C 


ESC,C 


ACK 


ESC A 


ESC, 


A 


ESC, A 


SUB 


LF 


LF 


LF 


LF 


ES C.X.I. 
ESC,Y,c 
Standard 


ESC, L $ 1» 

Ahhil 


ESC, f, c,l 
Standard 


DLE,c,l 
Abs 


N/A 


ESC.C1L 
N/A 


ESC,L 


DC1 


N/A 


ESC,@ 


DC3 


N/A 


ESC, 


,1M 


ESC,M 


DC2 


N/A 


ESC, 


IP 


ESC,P 


DC4 


N/A 


ESC, 


H. 


ESC.H, 


FS 




ESC,[2J 


ESC. J 
Simulated 




Simulated 


Simulated 


Simulated 


Simulated 


Simulated 


Simulated 


Simulated 


N/A 


N/A 


ESC, 4 


EOT 


N/A 


N/A 


ESC, 3 


ENQ 


N/A 


N/A 




STX 


N/A 


N/A 




ETX 


N/A 


N/A 


! N/A 


GS 


N/A 


N/A 


N/A 


RS 


N/A 


N/A 


1 N/A 


VT 


N/A 


N/A 


N/A 


SYN 


N/A 


ESC, [7m 


ESC,b 


SO 


N/A 


ESC, 


,m 


ESC, a 


SI 



Input Translation 



! From To 



To 



From 



To 



From 



To 



ESC,S 
ESC,T 
ESC,U 
ESC,V 
ESC,W 
ESC,P 
ESC,Q 
ESC,R 

ESC a 

ESC, 

ESC 

ESC 



A 
B 

.D 



01H 
02H 
03H 
04H 
05H 
50H 
51H 
43H 
1AH 
OAH 
06 H 
08H 



1AH 
12H 
15H 
17H 
02H 
7EH 



06 H 
10H 
1AH 
08H 
OAH 
1AH 
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Terminal Class Codes 13 - 20 



j FILE ! CLASS13 i CLASS14 ! CLASS15 

TRS-80 II Elblt VDU ADDS 
[Func ! V D M j 1920 ! Regent 20 


CLASS20 | 
Informer 
304 j 


Ihome j soii | esc, 6,5 j soil 

CLEAR FF CAN, ESC, 0,0 FF 

EOS CAN DC4 Simulated 

EOL ETB SYN ESC,K 

LEFT BS BS NAK 

RIGHT ACK NAK ACK 

UP SUB SUB SUB 

DOWN LF LF LF 

X.Y DLE,c,l ESC, l,c ESC,Y,l,c 

Bias ! Abs j Special S Standard 


ESC,H ! 

ESC,Z 

ESC,/ 

ESC,Q 

BS 

ESC,C 

ESC, A 

LF 

ESC, Y, l.c 

Standard 


!lL J N/A j N/A | N/A 
IC N/A N/A N/A 
DL N/A N/A N/A 
DC N/A N/A N/A 
EU N/A N/A N/A 
KON Simulated Simulated Simulated 
KOFF Simulated Simulated Simulated 
PON N/A N/A N/A 
POFF N/A N/A N/A 
FON N/A N/A N/A 
FOFF N/A N/A N/A 
BON N/A N/A N/A 
BOFF N/A N/A N/A 
ULON N/A N/A N/A 
ULOFF N/A N/A N/A 
RVON SO N/A N/A 
IRVOFF ! SI j N/A j N/A 


ESC,L 

N/A 
ESC,\ 
ESC,N 
Simulated 
Simulated 
ESC,W 
ESC,X 
ESC,E 
ESC,F 
ESC,L 
ESC,M 

N/A 

N/A 
ESC, J 
ESC,K i 



i 

i i 


From 


To 


Input Translal 

From To 


;ion 

From 


To 


From 


To ! 


i 

1 

1 

1 

1 
i 


1CH 
1DH 
1EH 
1FH 
OOH 


08H 
06 H 
1AH 
OAH 
5CH 




15H 


08H 




I 

i 
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Temlnal Class Codes 21 - 24 



FILE 
Func 



CLASS21 
Data Media 



CLASS22 
IBM 
3101 



CLASS23 
SD SYSTEMS 
VDB 8024 



CLASS24 
Intertube 



HOME 

CLEAR 

EOS 

EOL 

LEFT 

RIGHT 

UP 

DOWN 

Bias 

IL 

IC 

DL 

DC 

EU 

KON 

KOFF 

PON 

POFF 

FON 

FOFF 

BON 

BOFF 

ULON 

ULOFF 

RVON 

RVOFF 



EM 
FF 
VT 
GS 
BS 
FS 
US 
LF 

RS,c,l 
Standard 
----- 

N/A 

N/A 

N/A 

N/A 
Simulated 
Simulated 
EOT 
CAN 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 



ESC,H 

ESC a L 

ESC, J 

ESC, I 

ESC,D 

cioU , C 

ESC, A 

LF 

ES C , Y , 1 , C 

Standard 



ESC,N 

ESC,P 

ESC,0 

ESC,Q 
N/A 

Simulated 

Simulated 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 



SOH 

FF 

CAN 

ETB 

BS 

AOK 

SUB 

LF 

ESC , ss , C , 1 

Standard 



N/A 
N/A 
N/A 
N/A 
N/A 

Simulated 

Simulated 
N/A 
N/A 
N/A 
N/A 

GS 

RS 

VT 

SYN 

SO 

SI 



SOH 
FF 

ESC,k 
ESC,K 



ACK 
SUB 
LF 

ESC, Y, l,e 
Standard 
--- 

N/A 
N/A 
N/A 
ESC,G 
Simulated 
Simulated 
special * 
special * 
N/A 
N/A 
special * 
special * 
N/A 
N/A 
special * 
special * 







Input Translation 








! j From 


To 


From 
*• 


To 


From 


To 


From 


To | 






ESC, A 


1AH 


OBH 


1AH 


15H 


08H | 






ESC,B 


OAH 


19H 


09H 










ESC,C 


06 H 














ESC,D 


08H 














ESC,H 
ESC, I 
ESC, J 
ESC,S 


01H 
17H 
18H 
18H 











* The output codes for these capabilities are interdependent. 



** System control keys require double ESC key lead-in ; i.e. 
function is performed by entering ESC, ESC, W. 



Console Screen Wait 



- 118 - 



SYSTEM Ber B 



APFEIDIX G: TEHMHAL CLASS CODES 



Terminal Class Codes 25-28 



FILE 


CLASS25 


CLASS26 


CLASS27 


CLASS28 




Volker-Craig 


Teleray 


Tektronix 


Visual 200 


Func j 


VC 404 i 


1000 


4025 


520+ mode 


HOME j 




ESC,H j 


l,U,P,3,3,3,3,CR 


SOH 


CLEAR 


CAN ! 


FF 


special 


FF 


EOS ! 


ETB 


ESC, J 


simulated 


ESC,y 


EOL 


SYN 


ESC,K 


!,D,C,H,8,0,CR 


ESC.x 


LEFT 


BS 


BS 


BS 


RIGHT 


NAK 


ESC,C 


j'8:?& CR 


ACK 


UP 


SUB 


ESC, A 


SUB 


DOWN 


LF 


LF 


LF 


X A Y 

Bias 


DLE,l,c 


ESC,Y,l,c 


DLE,l,VT,c 


ESC,Y,l,c 


Standard 


Standard 


Standard 


Standard 


IL 


N/A 


ESC,L 


1 , I,L, I, CR 


ESC.L 


IC 


N/A 


ESC P 


1 , I , C , H , CR 


N/A 


DL 


N/A 


ESC,M 


|,D,L,i;CR 


ESC,M 


DC 


N/A 


ESC,Q 


i ,D, C,H.CR 


ESC10 


EU 


N/A 


FF 


N/A 


ESC,W 


KON 


Simulated 


Simulated 


Simulated 


Simulated 


KOFF 


Simulated 


Simulated 


Simulated 


Simulated 


PON 


N/A 


special * 


special * 


ESC ,4 


POFF 


N/A 


special * 


special * 


ESC, 3 


FON 


N/A 


N/A 


N/A 


ESC, 6 


FOFF 


N/A 


N/A 


N/A 


ESC, 7 


BON 


N/A 


special * 


special * 


N/A 


BOFF 


N/A 


special * 


special * 


N/A 


ULON 


N/A 


special * 


special * 


N/A 


ULOFF 


N/A 


special * 


special * 


N/A 


RVON 


N/A 


special * 


special * 


N/A 


RVOFF 


N/A 


special * 


special * 


N/A 






Input Trans 


ilation 





From To i From 



To 



From 



To 



From 
"66H~" 



To 
'08H" 



* The output for these capabilities are interdependant. 
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Terminal Class Codes 29 - 32 



FILE 
Func 



CLASS29 
Heath H1 9 
i Heath mode 



CLASS30 

Zentec 

Zephyr 



CLASS31 

Televideo 

TVI 950 



CLASS32 



HOME 

CLEAR 

EOS 

EOL 

LEFT 

RIGHT 

UP 

DOWN 

x,y 

Coding 



IC 
DL 
DC 
EU 

KON 

KOFF 

PON 

POFF 

FON 

FOFF 

BON 

BOFF 

ULON 

ULOFF 

RVON 

RVOFF 



ESC,H 
ESC,E 
ESC, J 
ESC,K 
ESC,D 
ESC,C 
ESC, A 
LF 

ESC, Y, l,c 
Standard 



! ESC,L 

N/A 
ESC,M 
ESC,N 
ESC,E 

Simulated 
Simulated 



RS 

ESC,* 
ESC,Y 
ESC,T 
BS 
FF 
VT 
LF 

ESC, =,l,o 
Standard 



RS 

ESC,* 

ESC,Y 

ESC,T 

BS 

FF 

VT 

LF 

ESC, s, l,c 

Standard 



ESC,E 
ESC,Q 
ESC,R 
ESC,W 
ESC,+ 

Simulated 

Simulated 

ESC,) 

ESC,( 

ESC,& 

ESC,» 

special 

special 

special 

special 

special 

special 



ESC,E 
ESC,Q 
ESC,R 
ESC,W 

Simulated 

Simulated 

ESC,) 

ESC,( 

ESC,& 

ESC, » 

special 

special 

special 

special 

special 

special 



Input Translation 



! I From 


To 


From 


To 


From 


To ! From 


To I 


| ■ ** 








** 






ESC,S 


01H 


OBH 


1AH 


18H 


OAH ! 




ESC,T 


02H 


OCH 


06H 


OBH 


1AH 




ESC,U 


03H 
04H 


1EH 


01H 


OCH 


06H 




ESC,V 






1EH 


01H 




ESC,W 


05H 












ESC,P 


*1 












ESC,Q 


*2 












ESC,R 


*3 












ESC, A 


1AH 












ESC,B 


OAH 












ESC,C 


06 H 












ESC,D 


08H 












ESC,L 


11H 












ESC,M 


12H 












ESC,@ 


13H 
14H 












ESC,N 












! ! ESC,H 


01H 













• The output codes for these capabilities are interdependant. 

*1 Translated to Printer Echo-key. 

*2 Translated to System Cancel-key. 

*3 Translated to Program Cancel-key. 

** System control keys require double ESC key lead-in; i.e., Console Screen Wait 
function is performed by entering ESC, ESC, W. 
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APPEIDIX H 

PRIVILEGE LEVELS 

The OASIS operating system supports privileged access to programs. Privileged 
access means that each program is assigned a privilege value. Access to a specific 
program is allowed only if the current user has a privilege level equal to or 
greater than the privilege value of the program. 



An attempt to access a program with a privilege value 
level will be rejected with no error message. 



higher than your privilege 



The current privilege level may be lowered by using the SET PRIV command. 



The 
The 



current privilege level may be displayed by using the SHOW PRIV command, 
current privilege level is a SYSGENable function but this only has meaning when the 
user accounting feature is removed. 

The following table lists the OASIS commands and the privilege value associated 
with them, as they are distributed. This is not necessarily a complete list as new 
commands may be added. 



ACCOUNT 

ASSIGN 

ATTACH 

BACKUP 

BASCONV 

BASIC 

CHANGE 

COPYFILE 

CREATE 

DEBUG 

DUMPDISK 

EDIT 

ERASE 

FILECONV 



FILELIST 

4 FILT8080 

5 FORCE 

2 GETFILE 

3 INITDISK 

4 INTELHEX 

3 KILL 
2 LINK 
LIST 

5 LOAD 

LOGOFF 
LOGON 

4 MACRO 

MAILBOX 



MEMTEST 

MOUNT 

MSG 

OWNERCHG 

PATCH 

PEEK 

RECEIVE 

RECOVER 

RELOCATE 

RENAME 

REPAIR 

RUN 

SCHEDULE 

SCRIPT 



SECTOR 

SEND 

SET 

SHARE 

SHOW 

SPOOLER 

START 

STATE 

STOP 

SYSGEN 

TEXTEDIT 

TERMINAL 

UNLOAD 

VERIFY 



The privilege level of a program (COMMAND) may be 
using the CHANGE command. 



changed to a different value by 



Note 1 : Because the privilege level of the system cannot be raised by any program 

you should take care to always maintain at least one system disk that has the 

highest privilege level that you will ever need. This is usually accomplished by 

never making any changes to the copy of the system on the distibution disk. 

Note 2: Do not raise the privilege level of the LOGON and LOGOFF commands— you 
would make it very difficult to change from one account to another. Privilege 
values and levels may be in the range of to 5. The following conventions were 
used to determine the privilege values of the system programs: 

Non-file modifying system utilities, RUN version of BASIC. 

1 File modifying system utilities. 

2 High level language programming utilities. 

3 Maintenance utilities (i.e. PATCH). 

4 Assembly level language programming utilities. 

5 System management. 
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SYSTEM ERBORS AID MESSAGES 

1.1 Disk Errors 

All disk errors are displayed on the console after the disk retry count has been 
exhausted. The format of the disk error message is: 

Disk <fd>(<#» <aessage> <cyl>,<head>,<sect> 

Where? 

<fd> Indicates the logical disk label (S, A, B, etc). 

<#> Indicates the physical disk number that was attached to the logical disk 

J»aQ6cLe 

<message> Indicates the specific disk error message. 

<cyl> Indicates the cylinder number of the disk that the error occured on. This 
number is in decimal. 

<head> Indicates the head or surface number of the cylinder that the error 
occured on. This number is in decimal. 

<sect> Indicates the physical sector number within the cylinder of the disk 
error. This number is displayed in decimal. 

When a disk error occurs the system automatically retries the operation until it is 
successful or until the retry count is exhaused. If it is successful no indication 
of an error is given to the operator (except a slight delay in processing). When 
the operation is not successful and the retry count is exhausted an error message 
is displayed on the console and the system waits for a response from the operator. 

When a disk error message is displayed on the console the operator must type a key 
for processing to continue. Valid responses by the operator include: 

B Retry the operation again 

I Ignore the operation and continue processing as if the operation was 
successful. This response may cause more errors than intended. In 
general, only use the I response for read type operations and when 
you are sure that the information will not be used for a write 
operation following. 

Q Quit the operation and return control to the Command String 
Interpreter. 

M Perform a MOUNT for the error disk. This response is only valid when 
the error message is 'Disk Changed 1 . 

Caution should be exercised in the use of the I and Q responses. The actual 
results of this response will be dependent upon the specific operation being 
performed. However, the I response is invaluable when performing a disk backup or 
similar operation. Before using the I response you should try the R response 
several times to insure that the data is truly unrecoverable. 

The integrity of information written to or read from a disk is verified by use of a 
checksum or CRC value. CRC is the initials of the term "Cyclic Redundancy Check" 
and refers to the process of generating a value using an algorithm that relates the 
value generated to the information that it was generated from. This is a 
reasonably accurate and efficient method of verifying read/write integrity. When 
information is to be written to the disk a CRC value is generated and written along 
with the data. When the information is read back from the disk a CRC value is 
generated for the information read. If the CRC of the data read is not the same as 
the CRC read back with the data then there is an error. This error may be related 
to the data or it may be that the CRC value read from the disk is in error. 

The following disk error messages are described in alphabetic order. The number 
preceding the error message is the internal error number. 

Disk Error Messages 

9 Header Error - The sector or track address read from the disk does not 
correspond to its checksum read from the disk. Enter- a carriage return 
to retry the operation. 
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4 Data CHC Error - The data read from the disk does not correspond to its 
checksum read from the disk. Enter a carriage return to retry the 
operation. 

6 Disk Changed - The disk ID on the disk does not match the ID saved in 
memory. Mount the correct disk, unload this disk, or enter an M. 

5 Invalid Parameters - The sector number to be read/written is invalid 
(negative or greater than maximum). The data and/or program is 
invalid. This error usually only occurs during a read of a sequential 
file, indicating that the link address to the next block of the file is 
invalid. The only method of exiting from this error condition is the I 
or Q response. 

3 Not Initialized - Addresses and data on the disk cannot be read: system 
assumes the disk has not been formatted. To recover from this error 
you must quit and initialize the disk. If the error is occuring on 
many disks that are actually initialized then the head alignment of the 
disk drive should be suspected. 

1 Hot Ready - Disk not loaded, not rotating at proper speed, or is 
mounted off center. Unload and reload disk slowly. 

7 Sector Hot Found - Sector address is invalid or doesn't match its 
checksum. If the operation is a write to the disk then enter a 
carriage return to retry the operation - usually this will recover from 
the error. If the operation is a read, then you will probably have to 
cancel the operation and either restore the data from the backup disk 
(initialize this disk first) or try to recover the data using the DEBUG 
program (if available). The DEBUG program, if used improperly, may 
cause more loss of data than recovered! 

8 Track Hot Found - Track address is invalid or doesn't match its 
checksum. Retry the operation. If not recoverable restore from your 
backup disk. 

2 Write Protected - Disk is physically or logically write protected. 

The following errors may occur during system start up (boot): 

Disk Error: nn Indicates one of the above errors. The disk error 
message cannot be displayed because the system cannot be read into 
memory. Usually the error can be resolved by reloading the disk 
slowly, making sure that it is seated properly, etc. 

Hot Found: "SYSTEM. NUCLEUS" Indicates that a non-system disk is in the 
system drive. 

Hot Found: "SYSTEM. EXEC1" Indicates that the EXEC1 file is not on the 
system disk. This file must exist in order to complete the system 
start up. 

Hot Found: "SYSTBM.CSI" Indicates that a non-system disk is in the 
system drive. 

Hot Found: "SYSTEM. ERRMS6" Indicates that a non-system disk is in the 
system drive. 

1.2 Syste« Messages 

The following is a listing of the SYSTEM. ERRMSG file as distributed. The messages 
that contain numbers surrounded by braces {} indicate that the message contains 
variable information that is determined only at the time the message is displayed. 
For example, message number 42 is used by the STATE command to display the number 
of files found and the number of disk blocks used by those files. 

The messages are fairly self explanatory. More detail about the specific messages 
cannot be given because the messages are almost totally independent of the 
programs. In general, if a message is displayed that you do not know how to 
interpret then read the section or manual describing the program that was executing 
when the message was displayed. 
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Number Text 



.2 



9 
10 
11 
12 

n 

1 

[1 

19 

[20 

.21 

22 

2 

25 
26 

[U 

29 

30 

[31 

32 

[3" 
3 

[35 
r 3o 

III 

39 
40 
41 
,42 
43 
44 

[ Hi 
t* 

.49 

50 

[51 

.52 

5? 
54 

55 
56 
5 
5 

?9 
60 
61 
62 

n 

66 

\n 

.69 
70 
71 
72 
73 

[74 



Syntax error. 

File name missing. 

File type missing. 

Drive code missing. 

Disk not attached. 

Disk not mounted. 

Invalid option. 

File not found. 

Disk full. 

Directory full. 

Invalid file name. 

Invalid drive code. 

File l? {1}.{2} n not found. 

"{1}" is not recognizable. 

"{I} 11 is an invalid numeric. 

Expecting "{1}", found "{2}". 

Expecting "{1}", found end-of-line. 

Protected file. 

Insufficient privilege. 

Incorrect serial number. 

Expecting end-of-line, found "{1}". 

Required parameter missing. 

Must be "ON" or "OFF". 

Incorrect format, should be "{1}". 

Cannot detach the CONSOLE. 

Invalid record in n {1}.{2}". 

Cannot attach to an output only device. 

Cannot attach to an input only device. 

Can only attach to a random storage device. 

Cannot attach to a random storage device. 

Cannot detach the System disk. 

Undefined logical device. 

Undefined physical device. 

Must be sequential organization. 

File already exists. 

Organization code is missing. 

Missing option: "{1}". 

COMM device is not attached. 

Device is not attached. 

File channel is not assigned. 

No files found. 

{1} file(s). {2} block(s). 

Must have at least two disks attached. 

Source and destination drives cannot be the same. 

No files erased. 

{1} file(s) erased. {2} block(s) recovered. 

Source and destination do not have the same capacity, 

Receiver disconnected. 

Receiver timed out. 

Too many serial numbers. 

Load module contains unresolved external references. 

Cannot mix ABS with REL or COM modules. 

Cannot have multiple ABS modules. 

Symbol table overflow. 

Unexpected end-of-file. 

Program has no PABsl 

Only private files may be shared. 

SYSTEM. ACCOUNT file is missing. 

System account cannot share files. 

Incorrect password. 

Account not found. 

File "{1}.{2}:{3}" already exists on account "{4}". 

Spooler is not initialized. 

Spooler is busy printing. 

Spooler is waiting for work. 

Spooler is waiting for printer. 

Spooler is suspended. 

Insufficient Memory. 

Device is attached to partition {1}. 

Invalid partition number. 

Partition not allocated. 

Partition is still active. 

Partition is not active. 

Can't send message to your own partition. 
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User is not logged on. 

User is not receiving messages. 

Must be single user mode or private disk volume. 

Must be single user mode. 

Can only execute from System account. 

No files changed. 

File n {1}.{2> :{3} n is now owned by account M {4}". 

Partition size is too small. 

Partition size is too large. 

Partition must be one larger than current top partition. 

Can only modify top partition. 

Next lower parrtition is still active. 

Module {1} is not loaded. 

Module {1} is already loaded. 

Too many re-entrant modules. 

"{1} .{21 :{3}" filed. 

"Il}.l2}:{3}" saved. 

** Partition has been stopped! ** 

That account is in use by partition {1}. 

Cannot PEEK at yourself! 

Cannot FORCE yourself! 

All partitions are active. 

You have messages waiting. To retrieve, execute MAILBOX. 

Must be Multi-User OASIS. 



i 

Spooler is scheduling next job. 

Spooler has form rt { 1J{2} {3lt 4} {5} (6} (7) {8} w mounted. 

Spooler is stopped. 

Spool file is currently printing. 

Spool file is open or non-existent. 

Spol parameters: Queue={l}, Copies={2}, {3}. 

Logon at {1} f on {2}. 

Logoff at {1}, on {2} duration {3} minutes. 

Waiting for spooler to stop. 

Queue code and spoler form do not match. 

User can ! t be forced. 

Logon please: ! 

Password? J 



75 
76 

[81 
82 

rP 

hi 

89 
[90 
.91 

92 

3 
g 
8 

[99 
100 
101 
102 
103 
104 
105 
106 
107 
108 
109 
110 
111 
112 
113 
114 
115: 

Other messages may be added in the future as the need arises. 
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APPENDIX J 
ASCII CHARACTER SET 



Dec Hex Oct Binary Display Key 



Definition 



Special Use 



9 
10 
11 
12 

15 

16 

17 

18 

19 

20 

21 

22 

2 

2 

25 

26 

2 

2 

29 

30 

31 

32 

33 

34 

3 f 
36 

3 I 
38 

39 

40 

41 

42 

n 

45 
46 

SZ 

49 
50 
51 
52 

53 
54 

55 
56 
57 
58 

f 9 
60 

61 

62 

63 



00 000 

01 001 

02 002 

03 003 

04 004 

05 005 

06 006 

07 007 

08 010 

09 011 
OA 012 
OB 013 
OC 014 
OD 015 
OE 016 
OF 017 

10 020 

11 021 

12 022 

13 023 

14 024 

15 025 

16 026 

17 027 

18 030 

19 031 
1A 032 
1B 033 
1C 034 
1D 035 
1E 036 
1F 037 

20 040 

21 041 

22 042 



04' 
04^ 



25 045 

26 046 



II 



047 
050 

29 051 
2A 052 
2B 053 
2C 054 
2D 055 
2E 056 
2F 057 

30 060 

31 061 

32 062 



^ 



06 
06 



35 06 

36 06 



11 



067 
070 



39 071 
3 A 072 
3B 073 
3C 074 
3D 075 
3E 076 
3F 077 



0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0001 
0001 
0001 
0001 
0001 
0001 
0001 
0001 
0001 
0001 
0001 
0001 
0001 
0001 
0001 
0001 
0010 
0010 
0010 
0010 
0010 
0010 
0010 
0010 
0010 
0010 
0010 
0010 
0010 
0010 
0010 
0010 
0011 
0011 
0011 
0011 
0011 
0011 
0011 
0011 
0011 
0011 

0011 

0011 
0011 
0011 
0011 
0011 



0000 
0001 
0010 
0011 
0100 
0101 
0110 
0111 
1000 
1001 
1010 
1011 
1100 
1101 
1110 

1111 

0000 
0001 
0010 
0011 
0100 
0101 
0110 
0111 
1000 
1001 
1010 
1011 
1100 
1101 
1110 

1111 

0000 
0001 
0010 
0011 
0100 
0101 
0110 
0111 
1000 
1001 
1010 
1011 
1100 
1101 
1110 

1111 

0000 
0001 
0010 
0011 
0100 
0101 
0110 
0111 
1000 
1001 
1010 
1011 
1100 
1101 
1110 

1111 



CTRL/§ 
CTRL/A 
CTRL/B 
CTRL/C 
CTRL/D 
CTRL/E 
Right CTRL/F 
Bell CTRL/G 
CTRL/H 
CTRL/ I 
CTRL/ J 
CTRL/K 
CLEAR CTRL/L 



Home 

FON 

FOFF 

PON 

POFF 



BS 

TAB 

LF 



CR 



KOFF 

EOL 
EOS 
KON 
Up 



BON 
BOFF 



CTRL/M 

CTRL/N 

CTRL/0 

CTRL/P 

CTRL/Q 

CTRL/R 

CTRL/S 

CTRL/T 

CTRL/U 

CTRL/V 

CTRL/W 

CTRL/X 

CTRL/Y 

CTRL/Z 

CTRL/C 

CTRLA 

CTRL/1 

CTRL/ 

CTRL/_ 

space 

ir 

# 



% Percent symbol 



NUL Filler 

SOH Start of Heading 

STX Start of Text 

ETX End of Text 

EOT End Of Transmission 

ENQ Enquiry 

ACK Acknowledge 

BEL Bell 

BS Backspace 

HT Horizontal tabulation 

LF Line Feed 

VT Vertical tabulation 

FF Form Feed 

CR Carriage Return 

50 Shift Out 

51 Shift In 
DLE Data Link Escape 
DC1 Device Control 1 
DC2 Device Control 2 
DC3 Device Control 3 
DC4 Device Control 4 
NAK Negative Acknowledge 
SYN Synchronous Idle 

ETB End of Transmission Block 

CAN Cancel 

EM End of Medium 

SUB Substitute 

ESC Escape 

FS File separator 

GS Group separator 

RS Record separator 

US Unit separator 

SP - Space 

Exclamation mark 

Double quote 

Number symbol 

Dollar symbol 



Cursor address 



LINK prompt 



COPYFILE prompt 
. EDIT prompt 



BASIC prompt 



i I 



And - Ampersand 

Single quote 

Left parenthesis 

Right parenthesis 

Asterisk 

Plus symbol 

Comma 

Minus/Hyphen symbol 

Period/Decimal point 

Divide symbol - SI ash/ SI ant 

Zero 

One 

Two 

Three 

Four 

Five 

Six 

Seven 

Eight 

Nine 

Colon EXEC prompt 

Semicolon CSI comment 

Less than symbol - Left carrot 

Equal symbol DEBUG prompt 

Greater than/Right carrot CSI prompt 

Question mark 
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APPEHDIX J: ASCII CHARACTER SET 



Dec Hex Oct Binary Display Key 



Definition Special Use 

Commercial at sign - Atpersand 



64 
65 
66 

& 
ft 

71 
72 

U 

9 


81 

82 

8 

8 

85 

86 

8 

8 

89 

90 

91 

92 

9 

9 

$ 

II 

99 
100 
1.01 
102 
10 
10 
105 
106 
107 
108 
109 
110 
111 
112 
113 
114 
115 
116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 
127 



40 

41 

42 

4 

4 

4 

4 

4 

49 
4A 
4B 
4C 
4D 
4E 
4F 
50 
51 
52 

53 
54 

5 I 
56 

5 

5 

59 

5A 

5B 

5C 

5D 

5E 

5F 

60 

61 

62 

a 

65 

66 

II 

6B 
6C 
6D 
6E 
6F 
70 
71 
72 

n 

76 

R 

79 
7A 
7B 
7C 
7D 
7E 
7F 



00 

01 

02 





05 

06 

07 

10 

11 

12 

17 
20 
21 
22 
2 

25 

26 

27 

30 

31 

32 

3 

3 

11 

Vo 

41 

42 

4 

4 

45 

46 

47 

50 

51 

52 

5 

5 

5 ? 
56 

60 

61 

62 

6 

6 

65 

66 

67 

70 

71 

72 

73 

74 

7 ? 
76 

77 



0100 
0100 
0100 
0100 
0100 
0100 
0100 
0100 
0100 
0100 
0100 
0100 
0100 
0100 
0100 
0100 
0101 
0101 
0101 
0101 
0101 
0101 
0101 
0101 
0101 
0101 
0101 
0101 
0101 
0101 
0101 
0101 
0110 
0110 
0110 
0110 
0110 
0110 
0110 
0110 
0110 
0110 
0110 
0110 
0110 
0110 
0110 
0110 
0111 
0111 
0111 
0111 
0111 
0111 
0111 
0111 
0111 
0111 
0111 
0111 
0111 
0111 
0111 
0111 



0000 
0001 
0010 
0011 
0100 
0101 
0110 
0111 
1000 
1001 
1010 
1011 
1100 
1101 
1110 

1111 

0000 
0001 
0010 
0011 
0100 
0101 
0110 
0111 
1000 
1001 
1010 
1011 
1100 
1101 
1110 

1111 

0000 
0001 
0010 
0011 
0100 
0101 
0110 
0111 
1000 
1001 
1010 
1011 
1100 
1101 
1110 

1111 

0000 
0001 
0010 
0011 
0100 
0101 
0110 
0111 
1000 
1001 
1010 
1011 
1100 
1101 
1110 

1111 



@ 


@ 


A 


A 


B 


B 


C 


C 


D 


D 


E 


E 


F 


F 


G 


G 


H 


H 


I 


I 


J 


J 


K 


K 


L 


L 


M 


M 


N 


N 








P 


P 


Q 


Q 


R 


R 


S 


S 


T 


T 


U 


U 


V 


V 


W 


W 


X 


X 


Y 


Y 


Z 


Z 


C 


[ 


\ 


\ 


1 


I 



Left bracket 

Back slash/ slant 

Right bracket 

ASCII up arrow - circumflex 

Underscore 

Back quote 



PATCH prompt 



1 


1 




1! 

1 , 


i 

1 




m 


m 




n 


n 












P 
q 
r 


P 

q 

r 




s 

t 


s 
t 




u 


u 




V 


V 




w 


w 




X 


X 




y 

z 

{ 

1 

1 

DEL 


y 

z 

{ 

1 

i 

DEL 


Left brace 
Vertical bar 
Right brace 
Tilde 
RUBOUT 



SYSTEM Rev B 



- 127 - 



(This page intentionally left blank) 



- 128 - SYSTEM Rev B 



Reader's CoHents 

Name _^ : Date 

Organization 

Street 



City State Zip 

Name of manual: 



Did you find errors in this manual? If so, specify with page number. 



Did you find this manual understandable, usable, and well-organized? 
Please make suggestions for improvement. 



Is there sufficient documentation on associated system programs required for use of. 
the software described in this manual? If not, what material is missing and where 
should it be placed? 



Indicate the type of user/ reader that you most nearly represent: 

Assembly language programmer 

Higher-level language programmer (BASIC, FORTRAN, etc.) 

Occasional programmer (experienced) 

User with little programming experience 

Student programmer 

Non- programmer interested in computer concepts and capabilities 

Data entry operator 

Mail to: OASIS Documentation 

Phase One Systems. Inc. 
7700 Edgewater Drive #830 
Oakland, CA 94621 



